@itwin/core-backend 4.0.0-dev.4 → 4.0.0-dev.41

package/lib/cjs/ViewDefinition.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewDefinition.js","sourceRoot":"","sources":["../../src/ViewDefinition.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 ViewDefinitions\r\n */\r\n\r\nimport { Id64, Id64Array, Id64String, IModelStatus, JsonUtils } from \"@itwin/core-bentley\";\r\nimport {\r\n  Angle, Matrix3d, Point2d, Point3d, Range2d, Range3d, StandardViewIndex, Transform, Vector3d, YawPitchRollAngles,\r\n} from \"@itwin/core-geometry\";\r\nimport {\r\n  AuxCoordSystem2dProps, AuxCoordSystem3dProps, AuxCoordSystemProps, BisCodeSpec, Camera, CategorySelectorProps, Code, CodeScopeProps,\r\n  CodeSpec, ConcreteEntityTypes, EntityReferenceSet, IModelError, LightLocationProps, ModelSelectorProps, RelatedElement,\r\n  SpatialViewDefinitionProps, ViewAttachmentProps, ViewDefinition2dProps, ViewDefinition3dProps, ViewDefinitionProps, ViewDetails,\r\n  ViewDetails3d,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement, GraphicalElement2d, SpatialLocationElement } from \"./Element\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { DisplayStyle, DisplayStyle2d, DisplayStyle3d } from \"./DisplayStyle\";\r\nimport { IModelElementCloneContext } from \"./IModelElementCloneContext\";\r\n\r\n/** Holds the list of Ids of GeometricModels displayed by a [[SpatialViewDefinition]]. Multiple SpatialViewDefinitions may point to the same ModelSelector.\r\n * @see [ModelSelectorState]($frontend)\r\n * See [how to create a ModelSelector]$(docs/learning/backend/CreateElements.md#ModelSelector).\r\n * @public\r\n */\r\nexport class ModelSelector extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ModelSelector\"; }\r\n\r\n  /** The array of modelIds of the GeometricModels displayed by this ModelSelector */\r\n  public models: Id64String[];\r\n  /** @internal */\r\n  constructor(props: ModelSelectorProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.models = props.models;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ModelSelectorProps {\r\n    const val = super.toJSON() as ModelSelectorProps;\r\n    val.models = this.models;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    this.models.forEach((modelId: Id64String) => referenceIds.addModel(modelId));\r\n  }\r\n\r\n  /** Create a Code for a ModelSelector given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the ModelSelector and provides the scope for its name.\r\n   * @param codeValue The ModelSelector name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.modelSelector);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /**\r\n   * Create a ModelSelector to select which Models are displayed by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the ModelSelector\r\n   * @param models Array of models to select for display\r\n   * @returns The newly constructed ModelSelector element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, models: Id64Array): ModelSelector {\r\n    const modelSelectorProps: ModelSelectorProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      models,\r\n      isPrivate: false,\r\n    };\r\n    return new ModelSelector(modelSelectorProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert a ModelSelector to select which Models are displayed by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new ModelSelector into this DefinitionModel\r\n   * @param name The name/CodeValue of the ModelSelector\r\n   * @param models Array of models to select for display\r\n   * @returns The Id of the newly inserted ModelSelector element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, models: Id64Array): Id64String {\r\n    const modelSelector = this.create(iModelDb, definitionModelId, name, models);\r\n    return iModelDb.elements.insertElement(modelSelector.toJSON());\r\n  }\r\n}\r\n\r\n/** Holds a list of Ids of Categories to be displayed in a view.\r\n * @see [CategorySelectorState]($frontend)\r\n * See [how to create a CategorySelector]$(docs/learning/backend/CreateElements.md#CategorySelector).\r\n * @public\r\n */\r\nexport class CategorySelector extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"CategorySelector\"; }\r\n  /** The array of element Ids of the Categories selected by this CategorySelector */\r\n  public categories: Id64String[];\r\n  /** @internal */\r\n  constructor(props: CategorySelectorProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.categories = props.categories;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): CategorySelectorProps {\r\n    const val = super.toJSON() as CategorySelectorProps;\r\n    val.categories = this.categories;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    this.categories.forEach((categoryId: Id64String) => referenceIds.addElement(categoryId));\r\n  }\r\n\r\n  /** Create a Code for a CategorySelector given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the CategorySelector and provides the scope for its name.\r\n   * @param codeValue The CategorySelector name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.categorySelector);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /**\r\n   * Create a CategorySelector to select which categories are displayed by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name of the CategorySelector\r\n   * @param categories Array of categories to select for display\r\n   * @returns The newly constructed CategorySelector element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, categories: Id64Array): CategorySelector {\r\n    const categorySelectorProps: CategorySelectorProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      categories,\r\n      isPrivate: false,\r\n    };\r\n    return new CategorySelector(categorySelectorProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a CategorySelector to select which categories are displayed by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new CategorySelector into this DefinitionModel\r\n   * @param name The name of the CategorySelector\r\n   * @param categories Array of categories to select for display\r\n   * @returns The Id of the newly inserted CategorySelector element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, categories: Id64Array): Id64String {\r\n    const categorySelector = this.create(iModelDb, definitionModelId, name, categories);\r\n    return iModelDb.elements.insertElement(categorySelector.toJSON());\r\n  }\r\n}\r\n\r\n/**\r\n * The definition element for a view. ViewDefinitions specify the area/volume that is viewed, the Ids of a DisplayStyle and a CategorySelector,\r\n * plus additional view-specific parameters in their [[Element.jsonProperties]].\r\n *\r\n * Subclasses of ViewDefinition determine which model(s) are viewed.\r\n *\r\n * **Example: Obtaining the background color for a view**\r\n * ``` ts\r\n * [[include:ViewDefinition.getBackgroundColor]]\r\n * ```\r\n *\r\n * @note ViewDefinition is only available in the backend. See [ViewState]($frontend) for usage in the frontend.\r\n * @public\r\n */\r\nexport abstract class ViewDefinition extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition\"; }\r\n  /** The element Id of the [[CategorySelector]] for this ViewDefinition */\r\n  public categorySelectorId: Id64String;\r\n  /** The element Id of the [[DisplayStyle]] for this ViewDefinition */\r\n  public displayStyleId: Id64String;\r\n\r\n  /** @internal */\r\n  protected constructor(props: ViewDefinitionProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n\r\n    this.categorySelectorId = Id64.fromJSON(props.categorySelectorId);\r\n    if (!Id64.isValid(this.categorySelectorId))\r\n      throw new IModelError(IModelStatus.BadArg, `categorySelectorId is invalid`);\r\n\r\n    this.displayStyleId = Id64.fromJSON(props.displayStyleId);\r\n    if (!Id64.isValid(this.displayStyleId))\r\n      throw new IModelError(IModelStatus.BadArg, `displayStyleId is invalid`);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinitionProps {\r\n    const json = super.toJSON() as ViewDefinitionProps;\r\n    json.categorySelectorId = this.categorySelectorId;\r\n    json.displayStyleId = this.displayStyleId;\r\n    return json;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.categorySelectorId);\r\n    referenceIds.addElement(this.displayStyleId);\r\n    const acsId: Id64String = this.getAuxiliaryCoordinateSystemId();\r\n    if (Id64.isValidId64(acsId)) {\r\n      referenceIds.addElement(acsId);\r\n    }\r\n  }\r\n\r\n  /** @beta */\r\n  public static override readonly requiredReferenceKeys: ReadonlyArray<string> = [...super.requiredReferenceKeys, \"categorySelectorId\", \"displayStyleId\"];\r\n  /** @alpha */\r\n  public static override readonly requiredReferenceKeyTypeMap: Record<string, ConcreteEntityTypes> = {\r\n    ...super.requiredReferenceKeyTypeMap,\r\n    categorySelectorId: ConcreteEntityTypes.Element,\r\n    displayStyleId: ConcreteEntityTypes.Element,\r\n  };\r\n\r\n  /** @internal */\r\n  protected static override onCloned(context: IModelElementCloneContext, sourceElementProps: ViewDefinitionProps, targetElementProps: ViewDefinitionProps): void {\r\n    super.onCloned(context, sourceElementProps, targetElementProps);\r\n    if (context.isBetweenIModels && targetElementProps.jsonProperties && targetElementProps.jsonProperties.viewDetails) {\r\n      const acsId: Id64String = Id64.fromJSON(targetElementProps.jsonProperties.viewDetails.acs);\r\n      if (Id64.isValidId64(acsId)) {\r\n        targetElementProps.jsonProperties.viewDetails.acs = context.findTargetElementId(acsId);\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Type guard for `instanceof ViewDefinition3d`  */\r\n  public isView3d(): this is ViewDefinition3d { return this instanceof ViewDefinition3d; }\r\n  /** Type guard for 'instanceof ViewDefinition2d` */\r\n  public isView2d(): this is ViewDefinition2d { return this instanceof ViewDefinition2d; }\r\n  /** Type guard for `instanceof SpatialViewDefinition` */\r\n  public isSpatialView(): this is SpatialViewDefinition { return this instanceof SpatialViewDefinition; }\r\n  /** Type guard for 'instanceof DrawingViewDefinition' */\r\n  public isDrawingView(): this is DrawingViewDefinition { return this instanceof DrawingViewDefinition; }\r\n\r\n  /** Load this view's DisplayStyle from the IModelDb. */\r\n  public loadDisplayStyle(): DisplayStyle { return this.iModel.elements.getElement<DisplayStyle>(this.displayStyleId); }\r\n\r\n  /** Load this view's CategorySelector from the IModelDb. */\r\n  public loadCategorySelector(): CategorySelector { return this.iModel.elements.getElement<CategorySelector>(this.categorySelectorId); }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public abstract get details(): ViewDetails;\r\n\r\n  /** The Id of the AuxiliaryCoordinateSystem for this ViewDefinition, or an invalid Id if no ACS is defined. */\r\n  public getAuxiliaryCoordinateSystemId(): Id64String {\r\n    return this.details.auxiliaryCoordinateSystemId;\r\n  }\r\n\r\n  /** Set or clear the AuxiliaryCoordinateSystem for this ViewDefinition.\r\n   * @param acsId The Id of the new AuxiliaryCoordinateSystem. If `Id64.invalid` is passed, then no AuxiliaryCoordinateSystem will be used.\r\n   */\r\n  public setAuxiliaryCoordinateSystemId(acsId: Id64String) {\r\n    this.details.auxiliaryCoordinateSystemId = acsId;\r\n  }\r\n\r\n  /** Create a Code for a ViewDefinition given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel to contain the ViewDefinition and provides the scope for its name.\r\n   * @param codeValue The ViewDefinition name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.viewDefinition);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** Defines a view of one or more 3d models.\r\n * @public\r\n */\r\nexport abstract class ViewDefinition3d extends ViewDefinition {\r\n  private readonly _details: ViewDetails3d;\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition3d\"; }\r\n  /** If true, camera is used. Otherwise, use an orthographic projection. */\r\n  public cameraOn: boolean;\r\n  /** The lower left back corner of the view frustum. */\r\n  public origin: Point3d;\r\n  /** The extent (size) of the view frustum, in meters, along its x,y,z axes. */\r\n  public extents: Vector3d;\r\n  /** Rotation from world coordinates to view coordinates. */\r\n  public angles: YawPitchRollAngles;\r\n  /** The camera used for this view, if `cameraOn` is true. */\r\n  public camera: Camera;\r\n\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition3dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.cameraOn = JsonUtils.asBool(props.cameraOn);\r\n    this.origin = Point3d.fromJSON(props.origin);\r\n    this.extents = Vector3d.fromJSON(props.extents);\r\n    this.angles = YawPitchRollAngles.fromJSON(props.angles);\r\n    this.camera = new Camera(props.camera);\r\n    this._details = new ViewDetails3d(this.jsonProperties);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinition3dProps {\r\n    const val = super.toJSON() as ViewDefinition3dProps;\r\n    val.cameraOn = this.cameraOn;\r\n    val.origin = this.origin;\r\n    val.extents = this.extents;\r\n    val.angles = this.angles;\r\n    val.camera = this.camera;\r\n    return val;\r\n  }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public get details(): ViewDetails3d { return this._details; }\r\n\r\n  /** Load this view's DisplayStyle3d from the IModelDb. */\r\n  public loadDisplayStyle3d(): DisplayStyle3d { return this.iModel.elements.getElement<DisplayStyle3d>(this.displayStyleId); }\r\n}\r\n\r\n/** Defines a view of one or more SpatialModels.\r\n * The list of viewed models is stored by the ModelSelector.\r\n *\r\n * This is how a SpatialViewDefinition selects the elements to display:\r\n *\r\n *  SpatialViewDefinition\r\n *    * ModelSelector\r\n *        * ModelIds  -------> SpatialModels    <----------GeometricElement3d.Model\r\n *    * CategorySelector\r\n *        * CategoryIds -----> SpatialCategories <----------GeometricElement3d.Category\r\n * @public\r\n */\r\nexport class SpatialViewDefinition extends ViewDefinition3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SpatialViewDefinition\"; }\r\n  /** The Id of the [[ModelSelector]] for this SpatialViewDefinition. */\r\n  public modelSelectorId: Id64String;\r\n\r\n  /** @internal */\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.modelSelectorId = Id64.fromJSON(props.modelSelectorId);\r\n    if (!Id64.isValid(this.modelSelectorId))\r\n      throw new IModelError(IModelStatus.BadArg, `modelSelectorId is invalid`);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): SpatialViewDefinitionProps {\r\n    const json = super.toJSON() as SpatialViewDefinitionProps;\r\n    json.modelSelectorId = this.modelSelectorId;\r\n    return json;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.modelSelectorId);\r\n  }\r\n\r\n  /** @beta */\r\n  public static override readonly requiredReferenceKeys: ReadonlyArray<string> = [...super.requiredReferenceKeys, \"modelSelectorId\"];\r\n  /** @alpha */\r\n  public static override readonly requiredReferenceKeyTypeMap: Record<string, ConcreteEntityTypes> = {\r\n    ...super.requiredReferenceKeyTypeMap,\r\n    modelSelectorId: ConcreteEntityTypes.Element,\r\n  };\r\n\r\n  /** Load this view's ModelSelector from the IModelDb. */\r\n  public loadModelSelector(): ModelSelector { return this.iModel.elements.getElement<ModelSelector>(this.modelSelectorId); }\r\n  /**\r\n   * Create an SpatialViewDefinition with camera.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @param cameraAngle Camera angle in radians.\r\n   * @returns The newly constructed OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is a problem creating the view\r\n   */\r\n  public static createWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso, cameraAngle = Angle.piOver2Radians): SpatialViewDefinition {\r\n    const rotation = Matrix3d.createStandardWorldToView(standardView);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(rotation);\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    const cameraDistance = 2 * (rotatedRange.diagonal().magnitudeXY() / 2.0) / Math.tan(cameraAngle / 2.0);\r\n    const cameraLocation = rotatedRange.diagonalFractionToPoint(.5);    // Start at center.\r\n    cameraLocation.z += cameraDistance;                                 // Back up by camera distance.\r\n    rotation.multiplyTransposeVectorInPlace(cameraLocation);\r\n\r\n    const viewDefinitionProps: SpatialViewDefinitionProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      modelSelectorId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z),\r\n      extents: rotatedRange.diagonal(),\r\n      angles,\r\n      cameraOn: true,\r\n      camera: { lens: { radians: cameraAngle }, focusDist: cameraDistance, eye: cameraLocation },\r\n    };\r\n    return new SpatialViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert an SpatialViewDefinition with camera On\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new OrthographicViewDefinition into this DefinitionModel\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @param cameraAngle Camera angle in radians.\r\n   * @returns The Id of the newly inserted OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insertWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso, cameraAngle = Angle.piOver2Radians): Id64String {\r\n    const viewDefinition = this.createWithCamera(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView, cameraAngle);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n}\r\n\r\n/** Defines a spatial view that displays geometry on the image plane using a parallel orthographic projection.\r\n * See [how to create a OrthographicViewDefinition]$(docs/learning/backend/CreateElements.md#OrthographicViewDefinition).\r\n * @public\r\n */\r\nexport class OrthographicViewDefinition extends SpatialViewDefinition {\r\n  /** @internal */\r\n  public static override get className(): string { return \"OrthographicViewDefinition\"; }\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelDb) { super(props, iModel); }\r\n  /**\r\n   * Create an OrthographicViewDefinition\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @returns The newly constructed OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is a problem creating the view\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso): OrthographicViewDefinition {\r\n    const rotation = Matrix3d.createStandardWorldToView(standardView);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(rotation);\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    const viewDefinitionProps: SpatialViewDefinitionProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      modelSelectorId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z),\r\n      extents: rotatedRange.diagonal(),\r\n      angles,\r\n      cameraOn: false,\r\n      camera: new Camera(), // not used when cameraOn === false\r\n    };\r\n    return new OrthographicViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert an OrthographicViewDefinition\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new OrthographicViewDefinition into this DefinitionModel\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @returns The Id of the newly inserted OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso): Id64String {\r\n    const viewDefinition = this.create(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n  /** Set a new viewed range without changing the rotation or any other properties. */\r\n  public setRange(range: Range3d): void {\r\n    const rotation = this.angles.toMatrix3d();\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    this.origin = Point3d.createFrom(rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z));\r\n    this.extents = rotatedRange.diagonal();\r\n  }\r\n}\r\n\r\n/** Defines a view of a single 2d model. Each 2d model has its own coordinate system, so only one may appear per view.\r\n * @public\r\n */\r\nexport class ViewDefinition2d extends ViewDefinition {\r\n  private readonly _details: ViewDetails;\r\n\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition2d\"; }\r\n  /** The Id of the Model displayed by this view. */\r\n  public baseModelId: Id64String;\r\n  /** The lower-left corner of this view in Model coordinates. */\r\n  public origin: Point2d;\r\n  /** The delta (size) of this view, in meters, aligned with view x,y. */\r\n  public delta: Point2d;\r\n  /** The rotation of this view. */\r\n  public angle: Angle;\r\n\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition2dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.baseModelId = Id64.fromJSON(props.baseModelId);\r\n    this.origin = Point2d.fromJSON(props.origin);\r\n    this.delta = Point2d.fromJSON(props.delta);\r\n    this.angle = Angle.fromJSON(props.angle);\r\n    this._details = new ViewDetails(this.jsonProperties);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinition2dProps {\r\n    const val = super.toJSON() as ViewDefinition2dProps;\r\n    val.baseModelId = this.baseModelId;\r\n    val.origin = this.origin;\r\n    val.delta = this.delta;\r\n    val.angle = this.angle;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.baseModelId);\r\n  }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public get details(): ViewDetails { return this._details; }\r\n\r\n  /** Load this view's DisplayStyle2d from the IModelDb. */\r\n  public loadDisplayStyle2d(): DisplayStyle2d { return this.iModel.elements.getElement<DisplayStyle2d>(this.displayStyleId); }\r\n}\r\n\r\n/** Defines a view of a [[DrawingModel]].\r\n * @public\r\n */\r\nexport class DrawingViewDefinition extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DrawingViewDefinition\"; }\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition2dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n  }\r\n\r\n  /** Create a DrawingViewDefinition\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param baseModelId The base [[DrawingModel]]\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle2d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @throws [[IModelError]] if there is a problem creating the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, baseModelId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range2d): DrawingViewDefinition {\r\n    const viewDefinitionProps: ViewDefinition2dProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      baseModelId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: { x: range.low.x, y: range.low.y },\r\n      delta: range.diagonal(),\r\n      angle: 0,\r\n    };\r\n    return new DrawingViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n\r\n  /** Insert a DrawingViewDefinition\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new DrawingViewDefinition into this [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param baseModelId The base [[DrawingModel]]\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle2d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, baseModelId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range2d): Id64String {\r\n    const viewDefinition = this.create(iModelDb, definitionModelId, name, baseModelId, categorySelectorId, displayStyleId, range);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n}\r\n\r\n/** Defines a view of a [[SheetModel]].\r\n * @public\r\n */\r\nexport class SheetViewDefinition extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SheetViewDefinition\"; }\r\n}\r\n\r\n/** A ViewDefinition used to display a 2d template model.\r\n * @internal\r\n */\r\nexport class TemplateViewDefinition2d extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"TemplateViewDefinition2d\"; }\r\n}\r\n\r\n/** A ViewDefinition used to display a 3d template model.\r\n * @internal\r\n */\r\nexport class TemplateViewDefinition3d extends ViewDefinition3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"TemplateViewDefinition3d\"; }\r\n}\r\n\r\n/** An auxiliary coordinate system element. Auxiliary coordinate systems can be used by views to show\r\n * coordinate information in different units and/or orientations.\r\n * @public\r\n */\r\nexport abstract class AuxCoordSystem extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem\"; }\r\n  public type!: number;\r\n  public description?: string;\r\n  public constructor(props: AuxCoordSystemProps, iModel: IModelDb) { super(props, iModel); }\r\n}\r\n\r\n/** A 2d auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystem2d extends AuxCoordSystem {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem2d\"; }\r\n  public origin?: Point2d;\r\n  public angle!: number;\r\n  public constructor(props: AuxCoordSystem2dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Create a Code for a AuxCoordSystem2d element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystem2d element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystem2d name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystem2d);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** A 3d auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystem3d extends AuxCoordSystem {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem3d\"; }\r\n  public origin?: Point3d;\r\n  public yaw!: number;\r\n  public pitch!: number;\r\n  public roll!: number;\r\n  public constructor(props: AuxCoordSystem3dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Create a Code for a AuxCoordSystem3d element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystem3d element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystem3d name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystem3d);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** A spatial auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystemSpatial extends AuxCoordSystem3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystemSpatial\"; }\r\n  /** Create a Code for a AuxCoordSystemSpatial element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystemSpatial element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystemSpatial name\r\n   */\r\n  public static override createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystemSpatial);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** Represents an *attachment* of a [[ViewDefinition]] to a [[Sheet]].\r\n * @public\r\n */\r\nexport class ViewAttachment extends GraphicalElement2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewAttachment\"; }\r\n  public view: RelatedElement;\r\n  public constructor(props: ViewAttachmentProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.view = new RelatedElement(props.view);\r\n    // ###NOTE: scale, displayPriority, and clipping vectors are stored in ViewAttachmentProps.jsonProperties.\r\n  }\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.view.id);\r\n  }\r\n}\r\n\r\n/** The position in space of a Light.\r\n * @internal\r\n */\r\nexport class LightLocation extends SpatialLocationElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"LightLocation\"; }\r\n  /** Whether this light is currently turned on. */\r\n  public enabled!: boolean;\r\n  /** @internal */\r\n  constructor(props: LightLocationProps, iModel: IModelDb) { super(props, iModel); }\r\n}\r\n"]}
+{"version":3,"file":"ViewDefinition.js","sourceRoot":"","sources":["../../src/ViewDefinition.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 ViewDefinitions\r\n */\r\n\r\nimport { Id64, Id64Array, Id64String, IModelStatus, JsonUtils } from \"@itwin/core-bentley\";\r\nimport {\r\n  Angle, Matrix3d, Point2d, Point3d, Range2d, Range3d, StandardViewIndex, Transform, Vector3d, YawPitchRollAngles,\r\n} from \"@itwin/core-geometry\";\r\nimport {\r\n  AuxCoordSystem2dProps, AuxCoordSystem3dProps, AuxCoordSystemProps, BisCodeSpec, Camera, CategorySelectorProps, Code, CodeScopeProps,\r\n  CodeSpec, ConcreteEntityTypes, EntityReferenceSet, IModelError, LightLocationProps, ModelSelectorProps, RelatedElement,\r\n  SpatialViewDefinitionProps, ViewAttachmentProps, ViewDefinition2dProps, ViewDefinition3dProps, ViewDefinitionProps, ViewDetails,\r\n  ViewDetails3d,\r\n} from \"@itwin/core-common\";\r\nimport { DefinitionElement, GraphicalElement2d, SpatialLocationElement } from \"./Element\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { DisplayStyle, DisplayStyle2d, DisplayStyle3d } from \"./DisplayStyle\";\r\nimport { IModelElementCloneContext } from \"./IModelElementCloneContext\";\r\n\r\n/** Holds the list of Ids of GeometricModels displayed by a [[SpatialViewDefinition]]. Multiple SpatialViewDefinitions may point to the same ModelSelector.\r\n * @see [ModelSelectorState]($frontend)\r\n * See [how to create a ModelSelector]$(docs/learning/backend/CreateElements.md#ModelSelector).\r\n * @public\r\n */\r\nexport class ModelSelector extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ModelSelector\"; }\r\n\r\n  /** The array of modelIds of the GeometricModels displayed by this ModelSelector */\r\n  public models: Id64String[];\r\n  /** @internal */\r\n  constructor(props: ModelSelectorProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.models = props.models;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ModelSelectorProps {\r\n    const val = super.toJSON() as ModelSelectorProps;\r\n    val.models = this.models;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    this.models.forEach((modelId: Id64String) => referenceIds.addModel(modelId));\r\n  }\r\n\r\n  /** Create a Code for a ModelSelector given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the ModelSelector and provides the scope for its name.\r\n   * @param codeValue The ModelSelector name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.modelSelector);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /**\r\n   * Create a ModelSelector to select which Models are displayed by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the ModelSelector\r\n   * @param models Array of models to select for display\r\n   * @returns The newly constructed ModelSelector element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, models: Id64Array): ModelSelector {\r\n    const modelSelectorProps: ModelSelectorProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      models,\r\n      isPrivate: false,\r\n    };\r\n    return new ModelSelector(modelSelectorProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert a ModelSelector to select which Models are displayed by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new ModelSelector into this DefinitionModel\r\n   * @param name The name/CodeValue of the ModelSelector\r\n   * @param models Array of models to select for display\r\n   * @returns The Id of the newly inserted ModelSelector element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, models: Id64Array): Id64String {\r\n    const modelSelector = this.create(iModelDb, definitionModelId, name, models);\r\n    return iModelDb.elements.insertElement(modelSelector.toJSON());\r\n  }\r\n}\r\n\r\n/** Holds a list of Ids of Categories to be displayed in a view.\r\n * @see [CategorySelectorState]($frontend)\r\n * See [how to create a CategorySelector]$(docs/learning/backend/CreateElements.md#CategorySelector).\r\n * @public\r\n */\r\nexport class CategorySelector extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"CategorySelector\"; }\r\n  /** The array of element Ids of the Categories selected by this CategorySelector */\r\n  public categories: Id64String[];\r\n  /** @internal */\r\n  constructor(props: CategorySelectorProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.categories = props.categories;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): CategorySelectorProps {\r\n    const val = super.toJSON() as CategorySelectorProps;\r\n    val.categories = this.categories;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    this.categories.forEach((categoryId: Id64String) => referenceIds.addElement(categoryId));\r\n  }\r\n\r\n  /** Create a Code for a CategorySelector given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the CategorySelector and provides the scope for its name.\r\n   * @param codeValue The CategorySelector name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.categorySelector);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n\r\n  /**\r\n   * Create a CategorySelector to select which categories are displayed by a ViewDefinition.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name of the CategorySelector\r\n   * @param categories Array of categories to select for display\r\n   * @returns The newly constructed CategorySelector element.\r\n   * @throws [[IModelError]] if unable to create the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, categories: Id64Array): CategorySelector {\r\n    const categorySelectorProps: CategorySelectorProps = {\r\n      classFullName: this.classFullName,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      model: definitionModelId,\r\n      categories,\r\n      isPrivate: false,\r\n    };\r\n    return new CategorySelector(categorySelectorProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert a CategorySelector to select which categories are displayed by a ViewDefinition.\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new CategorySelector into this DefinitionModel\r\n   * @param name The name of the CategorySelector\r\n   * @param categories Array of categories to select for display\r\n   * @returns The Id of the newly inserted CategorySelector element.\r\n   * @throws [[IModelError]] if unable to insert the element.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, categories: Id64Array): Id64String {\r\n    const categorySelector = this.create(iModelDb, definitionModelId, name, categories);\r\n    return iModelDb.elements.insertElement(categorySelector.toJSON());\r\n  }\r\n}\r\n\r\n/**\r\n * The definition element for a view. ViewDefinitions specify the area/volume that is viewed, the Ids of a DisplayStyle and a CategorySelector,\r\n * plus additional view-specific parameters in their [[Element.jsonProperties]].\r\n *\r\n * Subclasses of ViewDefinition determine which model(s) are viewed.\r\n *\r\n * **Example: Obtaining the background color for a view**\r\n * ``` ts\r\n * [[include:ViewDefinition.getBackgroundColor]]\r\n * ```\r\n *\r\n * @note ViewDefinition is only available in the backend. See [ViewState]($frontend) for usage in the frontend.\r\n * @public\r\n */\r\nexport abstract class ViewDefinition extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition\"; }\r\n  /** The element Id of the [[CategorySelector]] for this ViewDefinition */\r\n  public categorySelectorId: Id64String;\r\n  /** The element Id of the [[DisplayStyle]] for this ViewDefinition */\r\n  public displayStyleId: Id64String;\r\n\r\n  /** @internal */\r\n  protected constructor(props: ViewDefinitionProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n\r\n    this.categorySelectorId = Id64.fromJSON(props.categorySelectorId);\r\n    if (!Id64.isValid(this.categorySelectorId))\r\n      throw new IModelError(IModelStatus.BadArg, `categorySelectorId is invalid`);\r\n\r\n    this.displayStyleId = Id64.fromJSON(props.displayStyleId);\r\n    if (!Id64.isValid(this.displayStyleId))\r\n      throw new IModelError(IModelStatus.BadArg, `displayStyleId is invalid`);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinitionProps {\r\n    const json = super.toJSON() as ViewDefinitionProps;\r\n    json.categorySelectorId = this.categorySelectorId;\r\n    json.displayStyleId = this.displayStyleId;\r\n    return json;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.categorySelectorId);\r\n    referenceIds.addElement(this.displayStyleId);\r\n    const acsId: Id64String = this.getAuxiliaryCoordinateSystemId();\r\n    if (Id64.isValidId64(acsId)) {\r\n      referenceIds.addElement(acsId);\r\n    }\r\n  }\r\n\r\n  /** @beta */\r\n  public static override readonly requiredReferenceKeys: ReadonlyArray<string> = [...super.requiredReferenceKeys, \"categorySelectorId\", \"displayStyleId\"];\r\n  /** @alpha */\r\n  public static override readonly requiredReferenceKeyTypeMap: Record<string, ConcreteEntityTypes> = {\r\n    ...super.requiredReferenceKeyTypeMap,\r\n    categorySelectorId: ConcreteEntityTypes.Element,\r\n    displayStyleId: ConcreteEntityTypes.Element,\r\n  };\r\n\r\n  /** @internal */\r\n  protected static override onCloned(context: IModelElementCloneContext, sourceElementProps: ViewDefinitionProps, targetElementProps: ViewDefinitionProps): void {\r\n    super.onCloned(context, sourceElementProps, targetElementProps);\r\n    if (context.isBetweenIModels && targetElementProps.jsonProperties && targetElementProps.jsonProperties.viewDetails) {\r\n      const acsId: Id64String = Id64.fromJSON(targetElementProps.jsonProperties.viewDetails.acs);\r\n      if (Id64.isValidId64(acsId)) {\r\n        targetElementProps.jsonProperties.viewDetails.acs = context.findTargetElementId(acsId);\r\n      }\r\n    }\r\n  }\r\n\r\n  /** Type guard for `instanceof ViewDefinition3d`  */\r\n  public isView3d(): this is ViewDefinition3d { return this instanceof ViewDefinition3d; }\r\n  /** Type guard for 'instanceof ViewDefinition2d` */\r\n  public isView2d(): this is ViewDefinition2d { return this instanceof ViewDefinition2d; }\r\n  /** Type guard for `instanceof SpatialViewDefinition` */\r\n  public isSpatialView(): this is SpatialViewDefinition { return this instanceof SpatialViewDefinition; }\r\n  /** Type guard for 'instanceof DrawingViewDefinition' */\r\n  public isDrawingView(): this is DrawingViewDefinition { return this instanceof DrawingViewDefinition; }\r\n\r\n  /** Load this view's DisplayStyle from the IModelDb. */\r\n  public loadDisplayStyle(): DisplayStyle { return this.iModel.elements.getElement<DisplayStyle>(this.displayStyleId); }\r\n\r\n  /** Load this view's CategorySelector from the IModelDb. */\r\n  public loadCategorySelector(): CategorySelector { return this.iModel.elements.getElement<CategorySelector>(this.categorySelectorId); }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public abstract get details(): ViewDetails;\r\n\r\n  /** The Id of the AuxiliaryCoordinateSystem for this ViewDefinition, or an invalid Id if no ACS is defined. */\r\n  public getAuxiliaryCoordinateSystemId(): Id64String {\r\n    return this.details.auxiliaryCoordinateSystemId;\r\n  }\r\n\r\n  /** Set or clear the AuxiliaryCoordinateSystem for this ViewDefinition.\r\n   * @param acsId The Id of the new AuxiliaryCoordinateSystem. If `Id64.invalid` is passed, then no AuxiliaryCoordinateSystem will be used.\r\n   */\r\n  public setAuxiliaryCoordinateSystemId(acsId: Id64String) {\r\n    this.details.auxiliaryCoordinateSystemId = acsId;\r\n  }\r\n\r\n  /** Create a Code for a ViewDefinition given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel to contain the ViewDefinition and provides the scope for its name.\r\n   * @param codeValue The ViewDefinition name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.viewDefinition);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** Defines a view of one or more 3d models.\r\n * @public\r\n */\r\nexport abstract class ViewDefinition3d extends ViewDefinition {\r\n  private readonly _details: ViewDetails3d;\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition3d\"; }\r\n  /** If true, camera is used. Otherwise, use an orthographic projection. */\r\n  public cameraOn: boolean;\r\n  /** The lower left back corner of the view frustum. */\r\n  public origin: Point3d;\r\n  /** The extent (size) of the view frustum, in meters, along its x,y,z axes. */\r\n  public extents: Vector3d;\r\n  /** Rotation from world coordinates to view coordinates. */\r\n  public angles: YawPitchRollAngles;\r\n  /** The camera used for this view, if `cameraOn` is true. */\r\n  public camera: Camera;\r\n\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition3dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.cameraOn = JsonUtils.asBool(props.cameraOn);\r\n    this.origin = Point3d.fromJSON(props.origin);\r\n    this.extents = Vector3d.fromJSON(props.extents);\r\n    this.angles = YawPitchRollAngles.fromJSON(props.angles);\r\n    this.camera = new Camera(props.camera);\r\n    this._details = new ViewDetails3d(this.jsonProperties);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinition3dProps {\r\n    const val = super.toJSON() as ViewDefinition3dProps;\r\n    val.cameraOn = this.cameraOn;\r\n    val.origin = this.origin;\r\n    val.extents = this.extents;\r\n    val.angles = this.angles;\r\n    val.camera = this.camera;\r\n    return val;\r\n  }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public get details(): ViewDetails3d { return this._details; }\r\n\r\n  /** Load this view's DisplayStyle3d from the IModelDb. */\r\n  public loadDisplayStyle3d(): DisplayStyle3d { return this.iModel.elements.getElement<DisplayStyle3d>(this.displayStyleId); }\r\n}\r\n\r\n/** Defines a view of one or more SpatialModels.\r\n * The list of viewed models is stored by the ModelSelector.\r\n *\r\n * This is how a SpatialViewDefinition selects the elements to display:\r\n *\r\n *  SpatialViewDefinition\r\n *    * ModelSelector\r\n *        * ModelIds  -------> SpatialModels    <----------GeometricElement3d.Model\r\n *    * CategorySelector\r\n *        * CategoryIds -----> SpatialCategories <----------GeometricElement3d.Category\r\n * @public\r\n */\r\nexport class SpatialViewDefinition extends ViewDefinition3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SpatialViewDefinition\"; }\r\n  /** The Id of the [[ModelSelector]] for this SpatialViewDefinition. */\r\n  public modelSelectorId: Id64String;\r\n\r\n  /** @internal */\r\n  public constructor(props: SpatialViewDefinitionProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.modelSelectorId = Id64.fromJSON(props.modelSelectorId);\r\n    if (!Id64.isValid(this.modelSelectorId))\r\n      throw new IModelError(IModelStatus.BadArg, `modelSelectorId is invalid`);\r\n  }\r\n\r\n  /** Construct a SpatialViewDefinition from its JSON representation. */\r\n  public static fromJSON(props: Omit<SpatialViewDefinitionProps, \"classFullName\">, iModel: IModelDb) {\r\n    return new SpatialViewDefinition({ ...props, classFullName: this.classFullName }, iModel);\r\n  }\r\n\r\n  /** Convert this view to its JSON representation. */\r\n  public override toJSON(): SpatialViewDefinitionProps {\r\n    const json = super.toJSON() as SpatialViewDefinitionProps;\r\n    json.modelSelectorId = this.modelSelectorId;\r\n    return json;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.modelSelectorId);\r\n  }\r\n\r\n  /** @beta */\r\n  public static override readonly requiredReferenceKeys: ReadonlyArray<string> = [...super.requiredReferenceKeys, \"modelSelectorId\"];\r\n\r\n  /** @alpha */\r\n  public static override readonly requiredReferenceKeyTypeMap: Record<string, ConcreteEntityTypes> = {\r\n    ...super.requiredReferenceKeyTypeMap,\r\n    modelSelectorId: ConcreteEntityTypes.Element,\r\n  };\r\n\r\n  /** Load this view's ModelSelector from the IModelDb. */\r\n  public loadModelSelector(): ModelSelector { return this.iModel.elements.getElement<ModelSelector>(this.modelSelectorId); }\r\n  /**\r\n   * Create a SpatialViewDefinition with the camera turned on.\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @param cameraAngle Camera angle in radians.\r\n   * @returns The newly constructed SpatialViewDefinition element\r\n   * @throws [[IModelError]] if there is a problem creating the view\r\n   */\r\n  public static createWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso, cameraAngle = Angle.piOver2Radians): SpatialViewDefinition {\r\n    const rotation = Matrix3d.createStandardWorldToView(standardView);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(rotation);\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    const cameraDistance = 2 * (rotatedRange.diagonal().magnitudeXY() / 2.0) / Math.tan(cameraAngle / 2.0);\r\n    const cameraLocation = rotatedRange.diagonalFractionToPoint(.5);    // Start at center.\r\n    cameraLocation.z += cameraDistance;                                 // Back up by camera distance.\r\n    rotation.multiplyTransposeVectorInPlace(cameraLocation);\r\n\r\n    const viewDefinitionProps: SpatialViewDefinitionProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      modelSelectorId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z),\r\n      extents: rotatedRange.diagonal(),\r\n      angles,\r\n      cameraOn: true,\r\n      camera: { lens: { radians: cameraAngle }, focusDist: cameraDistance, eye: cameraLocation },\r\n    };\r\n\r\n    return new SpatialViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n  /**\r\n   * Insert an SpatialViewDefinition with the camera turned on.\r\n   * @see [[createWithCamera]] for details.\r\n   * @returns The Id of the newly inserted SpatialViewDefinition element\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insertWithCamera(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso, cameraAngle = Angle.piOver2Radians): Id64String {\r\n    const viewDefinition = this.createWithCamera(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView, cameraAngle);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n}\r\n\r\n/** Defines a spatial view that displays geometry on the image plane using a parallel orthographic projection.\r\n * See [how to create a OrthographicViewDefinition]$(docs/learning/backend/CreateElements.md#OrthographicViewDefinition).\r\n * @public\r\n */\r\nexport class OrthographicViewDefinition extends SpatialViewDefinition {\r\n  /** @internal */\r\n  public static override get className(): string { return \"OrthographicViewDefinition\"; }\r\n  constructor(props: SpatialViewDefinitionProps, iModel: IModelDb) { super(props, iModel); }\r\n  /**\r\n   * Create an OrthographicViewDefinition\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @returns The newly constructed OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is a problem creating the view\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso): OrthographicViewDefinition {\r\n    const rotation = Matrix3d.createStandardWorldToView(standardView);\r\n    const angles = YawPitchRollAngles.createFromMatrix3d(rotation);\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    const viewDefinitionProps: SpatialViewDefinitionProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      modelSelectorId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z),\r\n      extents: rotatedRange.diagonal(),\r\n      angles,\r\n      cameraOn: false,\r\n      camera: new Camera(), // not used when cameraOn === false\r\n    };\r\n    return new OrthographicViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n\r\n  /**\r\n   * Insert an OrthographicViewDefinition\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new OrthographicViewDefinition into this DefinitionModel\r\n   * @param name The name/CodeValue of the view\r\n   * @param modelSelectorId The [[ModelSelector]] that this view should use\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle3d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @param standardView Optionally defines the view's rotation\r\n   * @returns The Id of the newly inserted OrthographicViewDefinition element\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, modelSelectorId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range3d, standardView = StandardViewIndex.Iso): Id64String {\r\n    const viewDefinition = this.create(iModelDb, definitionModelId, name, modelSelectorId, categorySelectorId, displayStyleId, range, standardView);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n\r\n  /** Set a new viewed range without changing the rotation or any other properties. */\r\n  public setRange(range: Range3d): void {\r\n    const rotation = this.angles.toMatrix3d();\r\n    const rotationTransform = Transform.createOriginAndMatrix(undefined, rotation);\r\n    const rotatedRange = rotationTransform.multiplyRange(range);\r\n    this.origin = Point3d.createFrom(rotation.multiplyTransposeXYZ(rotatedRange.low.x, rotatedRange.low.y, rotatedRange.low.z));\r\n    this.extents = rotatedRange.diagonal();\r\n  }\r\n}\r\n\r\n/** Defines a view of a single 2d model. Each 2d model has its own coordinate system, so only one may appear per view.\r\n * @public\r\n */\r\nexport class ViewDefinition2d extends ViewDefinition {\r\n  private readonly _details: ViewDetails;\r\n\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewDefinition2d\"; }\r\n  /** The Id of the Model displayed by this view. */\r\n  public baseModelId: Id64String;\r\n  /** The lower-left corner of this view in Model coordinates. */\r\n  public origin: Point2d;\r\n  /** The delta (size) of this view, in meters, aligned with view x,y. */\r\n  public delta: Point2d;\r\n  /** The rotation of this view. */\r\n  public angle: Angle;\r\n\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition2dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.baseModelId = Id64.fromJSON(props.baseModelId);\r\n    this.origin = Point2d.fromJSON(props.origin);\r\n    this.delta = Point2d.fromJSON(props.delta);\r\n    this.angle = Angle.fromJSON(props.angle);\r\n    this._details = new ViewDetails(this.jsonProperties);\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ViewDefinition2dProps {\r\n    const val = super.toJSON() as ViewDefinition2dProps;\r\n    val.baseModelId = this.baseModelId;\r\n    val.origin = this.origin;\r\n    val.delta = this.delta;\r\n    val.angle = this.angle;\r\n    return val;\r\n  }\r\n\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.baseModelId);\r\n  }\r\n\r\n  /** Provides access to optional detail settings for this view. */\r\n  public get details(): ViewDetails { return this._details; }\r\n\r\n  /** Load this view's DisplayStyle2d from the IModelDb. */\r\n  public loadDisplayStyle2d(): DisplayStyle2d { return this.iModel.elements.getElement<DisplayStyle2d>(this.displayStyleId); }\r\n}\r\n\r\n/** Defines a view of a [[DrawingModel]].\r\n * @public\r\n */\r\nexport class DrawingViewDefinition extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"DrawingViewDefinition\"; }\r\n  /** @internal */\r\n  public constructor(props: ViewDefinition2dProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n  }\r\n\r\n  /** Create a DrawingViewDefinition\r\n   * @param iModelDb The iModel\r\n   * @param definitionModelId The [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param baseModelId The base [[DrawingModel]]\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle2d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @throws [[IModelError]] if there is a problem creating the element.\r\n   */\r\n  public static create(iModelDb: IModelDb, definitionModelId: Id64String, name: string, baseModelId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range2d): DrawingViewDefinition {\r\n    const viewDefinitionProps: ViewDefinition2dProps = {\r\n      classFullName: this.classFullName,\r\n      model: definitionModelId,\r\n      code: this.createCode(iModelDb, definitionModelId, name),\r\n      baseModelId,\r\n      categorySelectorId,\r\n      displayStyleId,\r\n      origin: { x: range.low.x, y: range.low.y },\r\n      delta: range.diagonal(),\r\n      angle: 0,\r\n    };\r\n    return new DrawingViewDefinition(viewDefinitionProps, iModelDb);\r\n  }\r\n\r\n  /** Construct a DrawingViewDefinition from its JSON representation. */\r\n  public static fromJSON(props: Omit<ViewDefinition2dProps, \"classFullName\">, iModel: IModelDb) {\r\n    return new DrawingViewDefinition({ ...props, classFullName: this.classFullName }, iModel);\r\n  }\r\n\r\n  /** Insert a DrawingViewDefinition\r\n   * @param iModelDb Insert into this iModel\r\n   * @param definitionModelId Insert the new DrawingViewDefinition into this [[DefinitionModel]]\r\n   * @param name The name/CodeValue of the view\r\n   * @param baseModelId The base [[DrawingModel]]\r\n   * @param categorySelectorId The [[CategorySelector]] that this view should use\r\n   * @param displayStyleId The [[DisplayStyle2d]] that this view should use\r\n   * @param range Defines the view origin and extents\r\n   * @throws [[IModelError]] if there is an insert problem.\r\n   */\r\n  public static insert(iModelDb: IModelDb, definitionModelId: Id64String, name: string, baseModelId: Id64String, categorySelectorId: Id64String, displayStyleId: Id64String, range: Range2d): Id64String {\r\n    const viewDefinition = this.create(iModelDb, definitionModelId, name, baseModelId, categorySelectorId, displayStyleId, range);\r\n    return iModelDb.elements.insertElement(viewDefinition.toJSON());\r\n  }\r\n}\r\n\r\n/** Defines a view of a [[SheetModel]].\r\n * @public\r\n */\r\nexport class SheetViewDefinition extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"SheetViewDefinition\"; }\r\n}\r\n\r\n/** A ViewDefinition used to display a 2d template model.\r\n * @internal\r\n */\r\nexport class TemplateViewDefinition2d extends ViewDefinition2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"TemplateViewDefinition2d\"; }\r\n}\r\n\r\n/** A ViewDefinition used to display a 3d template model.\r\n * @internal\r\n */\r\nexport class TemplateViewDefinition3d extends ViewDefinition3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"TemplateViewDefinition3d\"; }\r\n}\r\n\r\n/** An auxiliary coordinate system element. Auxiliary coordinate systems can be used by views to show\r\n * coordinate information in different units and/or orientations.\r\n * @public\r\n */\r\nexport abstract class AuxCoordSystem extends DefinitionElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem\"; }\r\n  public type!: number;\r\n  public description?: string;\r\n  public constructor(props: AuxCoordSystemProps, iModel: IModelDb) { super(props, iModel); }\r\n}\r\n\r\n/** A 2d auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystem2d extends AuxCoordSystem {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem2d\"; }\r\n  public origin?: Point2d;\r\n  public angle!: number;\r\n  public constructor(props: AuxCoordSystem2dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Create a Code for a AuxCoordSystem2d element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystem2d element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystem2d name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystem2d);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** A 3d auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystem3d extends AuxCoordSystem {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystem3d\"; }\r\n  public origin?: Point3d;\r\n  public yaw!: number;\r\n  public pitch!: number;\r\n  public roll!: number;\r\n  public constructor(props: AuxCoordSystem3dProps, iModel: IModelDb) { super(props, iModel); }\r\n\r\n  /** Create a Code for a AuxCoordSystem3d element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystem3d element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystem3d name\r\n   */\r\n  public static createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystem3d);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** A spatial auxiliary coordinate system.\r\n * @public\r\n */\r\nexport class AuxCoordSystemSpatial extends AuxCoordSystem3d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"AuxCoordSystemSpatial\"; }\r\n  /** Create a Code for a AuxCoordSystemSpatial element given a name that is meant to be unique within the scope of the specified DefinitionModel.\r\n   * @param iModel  The IModelDb\r\n   * @param scopeModelId The Id of the DefinitionModel that contains the AuxCoordSystemSpatial element and provides the scope for its name.\r\n   * @param codeValue The AuxCoordSystemSpatial name\r\n   */\r\n  public static override createCode(iModel: IModelDb, scopeModelId: CodeScopeProps, codeValue: string): Code {\r\n    const codeSpec: CodeSpec = iModel.codeSpecs.getByName(BisCodeSpec.auxCoordSystemSpatial);\r\n    return new Code({ spec: codeSpec.id, scope: scopeModelId, value: codeValue });\r\n  }\r\n}\r\n\r\n/** Represents an *attachment* of a [[ViewDefinition]] to a [[Sheet]].\r\n * @public\r\n */\r\nexport class ViewAttachment extends GraphicalElement2d {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ViewAttachment\"; }\r\n  public view: RelatedElement;\r\n  public constructor(props: ViewAttachmentProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.view = new RelatedElement(props.view);\r\n    // ###NOTE: scale, displayPriority, and clipping vectors are stored in ViewAttachmentProps.jsonProperties.\r\n  }\r\n  /** @internal */\r\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\r\n    super.collectReferenceConcreteIds(referenceIds);\r\n    referenceIds.addElement(this.view.id);\r\n  }\r\n}\r\n\r\n/** The position in space of a Light.\r\n * @internal\r\n */\r\nexport class LightLocation extends SpatialLocationElement {\r\n  /** @internal */\r\n  public static override get className(): string { return \"LightLocation\"; }\r\n  /** Whether this light is currently turned on. */\r\n  public enabled!: boolean;\r\n  /** @internal */\r\n  constructor(props: LightLocationProps, iModel: IModelDb) { super(props, iModel); }\r\n}\r\n"]}

package/lib/cjs/rpc/tracing.js

@@ -42,8 +42,7 @@ class RpcTrace {
     }
     /** Start the processing of an RpcActivity inside an OpenTelemetry span */
     static async runWithSpan(activity, fn) {
-        var _a;
-        return core_bentley_1.Tracing.withSpan((_a = activity.rpcMethod) !== null && _a !== void 0 ? _a : "unknown RPC method", async () => RpcTrace.run(activity, fn), {
+        return core_bentley_1.Tracing.withSpan(activity.rpcMethod ?? "unknown RPC method", async () => RpcTrace.run(activity, fn), {
             attributes: { ...core_common_1.RpcInvocation.sanitizeForLog(activity) },
             kind: core_bentley_1.SpanKind.SERVER,
         });

package/lib/cjs/rpc/tracing.js.map

@@ -1 +1 @@
-{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/rpc/tracing.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,0BAA0B;AAE1B,sDAAwE;AACxE,oDAAgE;AAChE,6CAAgD;AAChD,oEAAiE;AACjE,8CAA2C;AAE3C,4CAA4C;AAE5C;;;;;;GAMG;AACH,MAAa,QAAQ;IAGnB;;SAEK;IACE,MAAM,KAAK,eAAe;QAC/B,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAA6B,CAAC;IACjE,CAAC;IAED;;SAEK;IACE,MAAM,KAAK,qBAAqB;QACrC,IAAA,qBAAM,EAAC,SAAS,KAAK,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC,eAAe,CAAC;IAClC,CAAC;IAED,8CAA8C;IACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAI,QAAqB,EAAE,EAAoB;QACpE,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,0EAA0E;IACnE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAI,QAAqB,EAAE,EAAoB;;QAC5E,OAAO,sBAAO,CAAC,QAAQ,CAAC,MAAA,QAAQ,CAAC,SAAS,mCAAI,oBAAoB,EAAE,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE;YAC1G,UAAU,EAAE,EAAE,GAAG,2BAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE;YACzD,IAAI,EAAE,uBAAQ,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;;AA7BH,4BA8BC;AA7BgB,iBAAQ,GAAG,IAAI,+BAAiB,EAAE,CAAC;AA+BpD,gBAAgB;AAChB,SAAgB,iBAAiB,CAAC,sBAA+B,KAAK;IACpE,2BAAa,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,mDAAmD;IAE7F,IAAI,mBAAmB,EAAE;QACvB,IAAI;YACF,8DAA8D;YAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,qBAAqB,EAAE,uBAAU,CAAC,cAAc,CAAC,CAAC;YACrF,sBAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACzC,2BAAa,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,mEAAmE;SACtH;QAAC,OAAO,CAAC,EAAE;YACV,gEAAgE;YAChE,qBAAM,CAAC,QAAQ,CAAC,6CAAqB,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;YACxF,qBAAM,CAAC,YAAY,CAAC,6CAAqB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;SAC1D;KACF;IAED,0GAA0G;IAC1G,qBAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,2BAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;AACjG,CAAC;AAnBD,8CAmBC","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 RpcInterface\r\n */\r\n\r\n// cspell:ignore calltrace\r\n\r\nimport { assert, Logger, SpanKind, Tracing } from \"@itwin/core-bentley\";\r\nimport { RpcActivity, RpcInvocation } from \"@itwin/core-common\";\r\nimport { AsyncLocalStorage } from \"async_hooks\";\r\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\r\nimport { IModelHost } from \"../IModelHost\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/**\r\n * Utility for tracing Rpc activity processing. When multiple Rpc requests are being processed asynchronously, this\r\n * class can be used to correlate the current calltrace with the originating RpcActivity. This is used for automatic appending\r\n * of RpcActivity to log messages emitted during Rpc processing. It may also be used to retrieve the user accessToken\r\n * from the RpcActivity.\r\n * @public\r\n */\r\nexport class RpcTrace {\r\n  private static _storage = new AsyncLocalStorage();\r\n\r\n  /** Get the [RpcActivity]($common) for the currently executing async, or `undefined` if there is no\r\n   * RpcActivity in the current call stack.\r\n   * */\r\n  public static get currentActivity(): RpcActivity | undefined {\r\n    return RpcTrace._storage.getStore() as RpcActivity | undefined;\r\n  }\r\n\r\n  /** Get the [RpcActivity]($common) for the currently executing async. Asserts that the RpcActivity\r\n   * exists in the current call stack.\r\n   * */\r\n  public static get expectCurrentActivity(): RpcActivity {\r\n    assert(undefined !== RpcTrace.currentActivity);\r\n    return RpcTrace.currentActivity;\r\n  }\r\n\r\n  /** Start the processing of an RpcActivity. */\r\n  public static async run<T>(activity: RpcActivity, fn: () => Promise<T>): Promise<T> {\r\n    return RpcTrace._storage.run(activity, fn);\r\n  }\r\n\r\n  /** Start the processing of an RpcActivity inside an OpenTelemetry span */\r\n  public static async runWithSpan<T>(activity: RpcActivity, fn: () => Promise<T>): Promise<T> {\r\n    return Tracing.withSpan(activity.rpcMethod ?? \"unknown RPC method\", async () => RpcTrace.run(activity, fn), {\r\n      attributes: { ...RpcInvocation.sanitizeForLog(activity) },\r\n      kind: SpanKind.SERVER,\r\n    });\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport function initializeTracing(enableOpenTelemetry: boolean = false) {\r\n  RpcInvocation.runActivity = RpcTrace.run; // redirect the invocation processing to the tracer\r\n\r\n  if (enableOpenTelemetry) {\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\r\n      const api = require(\"@opentelemetry/api\");\r\n      const tracer = api.trace.getTracer(\"@itwin/core-backend\", IModelHost.backendVersion);\r\n      Tracing.enableOpenTelemetry(tracer, api);\r\n      RpcInvocation.runActivity = RpcTrace.runWithSpan; // wrap invocation in an OpenTelemetry span in addition to RpcTrace\r\n    } catch (e) {\r\n      // eslint-disable-next-line @typescript-eslint/naming-convention\r\n      Logger.logError(BackendLoggerCategory.IModelHost, \"Failed to initialize OpenTelemetry\");\r\n      Logger.logException(BackendLoggerCategory.IModelHost, e);\r\n    }\r\n  }\r\n\r\n  // set up static logger metadata to include current RpcActivity information for logs during rpc processing\r\n  Logger.staticMetaData.set(\"rpc\", () => RpcInvocation.sanitizeForLog(RpcTrace.currentActivity));\r\n}\r\n"]}
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/rpc/tracing.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,0BAA0B;AAE1B,sDAAwE;AACxE,oDAAgE;AAChE,6CAAgD;AAChD,oEAAiE;AACjE,8CAA2C;AAE3C,4CAA4C;AAE5C;;;;;;GAMG;AACH,MAAa,QAAQ;IAGnB;;SAEK;IACE,MAAM,KAAK,eAAe;QAC/B,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAA6B,CAAC;IACjE,CAAC;IAED;;SAEK;IACE,MAAM,KAAK,qBAAqB;QACrC,IAAA,qBAAM,EAAC,SAAS,KAAK,QAAQ,CAAC,eAAe,CAAC,CAAC;QAC/C,OAAO,QAAQ,CAAC,eAAe,CAAC;IAClC,CAAC;IAED,8CAA8C;IACvC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAI,QAAqB,EAAE,EAAoB;QACpE,OAAO,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,0EAA0E;IACnE,MAAM,CAAC,KAAK,CAAC,WAAW,CAAI,QAAqB,EAAE,EAAoB;QAC5E,OAAO,sBAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,oBAAoB,EAAE,KAAK,IAAI,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE;YAC1G,UAAU,EAAE,EAAE,GAAG,2BAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE;YACzD,IAAI,EAAE,uBAAQ,CAAC,MAAM;SACtB,CAAC,CAAC;IACL,CAAC;;AA7BH,4BA8BC;AA7BgB,iBAAQ,GAAG,IAAI,+BAAiB,EAAE,CAAC;AA+BpD,gBAAgB;AAChB,SAAgB,iBAAiB,CAAC,sBAA+B,KAAK;IACpE,2BAAa,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,mDAAmD;IAE7F,IAAI,mBAAmB,EAAE;QACvB,IAAI;YACF,8DAA8D;YAC9D,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,qBAAqB,EAAE,uBAAU,CAAC,cAAc,CAAC,CAAC;YACrF,sBAAO,CAAC,mBAAmB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;YACzC,2BAAa,CAAC,WAAW,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,mEAAmE;SACtH;QAAC,OAAO,CAAC,EAAE;YACV,gEAAgE;YAChE,qBAAM,CAAC,QAAQ,CAAC,6CAAqB,CAAC,UAAU,EAAE,oCAAoC,CAAC,CAAC;YACxF,qBAAM,CAAC,YAAY,CAAC,6CAAqB,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;SAC1D;KACF;IAED,0GAA0G;IAC1G,qBAAM,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,2BAAa,CAAC,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;AACjG,CAAC;AAnBD,8CAmBC","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 RpcInterface\r\n */\r\n\r\n// cspell:ignore calltrace\r\n\r\nimport { assert, Logger, SpanKind, Tracing } from \"@itwin/core-bentley\";\r\nimport { RpcActivity, RpcInvocation } from \"@itwin/core-common\";\r\nimport { AsyncLocalStorage } from \"async_hooks\";\r\nimport { BackendLoggerCategory } from \"../BackendLoggerCategory\";\r\nimport { IModelHost } from \"../IModelHost\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\n/**\r\n * Utility for tracing Rpc activity processing. When multiple Rpc requests are being processed asynchronously, this\r\n * class can be used to correlate the current calltrace with the originating RpcActivity. This is used for automatic appending\r\n * of RpcActivity to log messages emitted during Rpc processing. It may also be used to retrieve the user accessToken\r\n * from the RpcActivity.\r\n * @public\r\n */\r\nexport class RpcTrace {\r\n  private static _storage = new AsyncLocalStorage();\r\n\r\n  /** Get the [RpcActivity]($common) for the currently executing async, or `undefined` if there is no\r\n   * RpcActivity in the current call stack.\r\n   * */\r\n  public static get currentActivity(): RpcActivity | undefined {\r\n    return RpcTrace._storage.getStore() as RpcActivity | undefined;\r\n  }\r\n\r\n  /** Get the [RpcActivity]($common) for the currently executing async. Asserts that the RpcActivity\r\n   * exists in the current call stack.\r\n   * */\r\n  public static get expectCurrentActivity(): RpcActivity {\r\n    assert(undefined !== RpcTrace.currentActivity);\r\n    return RpcTrace.currentActivity;\r\n  }\r\n\r\n  /** Start the processing of an RpcActivity. */\r\n  public static async run<T>(activity: RpcActivity, fn: () => Promise<T>): Promise<T> {\r\n    return RpcTrace._storage.run(activity, fn);\r\n  }\r\n\r\n  /** Start the processing of an RpcActivity inside an OpenTelemetry span */\r\n  public static async runWithSpan<T>(activity: RpcActivity, fn: () => Promise<T>): Promise<T> {\r\n    return Tracing.withSpan(activity.rpcMethod ?? \"unknown RPC method\", async () => RpcTrace.run(activity, fn), {\r\n      attributes: { ...RpcInvocation.sanitizeForLog(activity) },\r\n      kind: SpanKind.SERVER,\r\n    });\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport function initializeTracing(enableOpenTelemetry: boolean = false) {\r\n  RpcInvocation.runActivity = RpcTrace.run; // redirect the invocation processing to the tracer\r\n\r\n  if (enableOpenTelemetry) {\r\n    try {\r\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\r\n      const api = require(\"@opentelemetry/api\");\r\n      const tracer = api.trace.getTracer(\"@itwin/core-backend\", IModelHost.backendVersion);\r\n      Tracing.enableOpenTelemetry(tracer, api);\r\n      RpcInvocation.runActivity = RpcTrace.runWithSpan; // wrap invocation in an OpenTelemetry span in addition to RpcTrace\r\n    } catch (e) {\r\n      // eslint-disable-next-line @typescript-eslint/naming-convention\r\n      Logger.logError(BackendLoggerCategory.IModelHost, \"Failed to initialize OpenTelemetry\");\r\n      Logger.logException(BackendLoggerCategory.IModelHost, e);\r\n    }\r\n  }\r\n\r\n  // set up static logger metadata to include current RpcActivity information for logs during rpc processing\r\n  Logger.staticMetaData.set(\"rpc\", () => RpcInvocation.sanitizeForLog(RpcTrace.currentActivity));\r\n}\r\n"]}

package/lib/cjs/rpc/web/request.js

@@ -11,14 +11,13 @@ exports.parseRequest = void 0;
 const core_common_1 = require("@itwin/core-common");
 /* eslint-disable deprecation/deprecation */
 function parseHeaders(protocol, req) {
-    var _a;
     const headerNames = protocol.serializedClientRequestContextHeaderNames;
     const parsedHeaders = {
         id: req.header(headerNames.id) || "",
         applicationId: req.header(headerNames.applicationId) || "",
         applicationVersion: req.header(headerNames.applicationVersion) || "",
         sessionId: req.header(headerNames.sessionId) || "",
-        authorization: (_a = (headerNames.authorization ? req.header(headerNames.authorization) : "")) !== null && _a !== void 0 ? _a : "",
+        authorization: (headerNames.authorization ? req.header(headerNames.authorization) : "") ?? "",
     };
     return parsedHeaders;
 }

package/lib/cjs/rpc/web/request.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../../src/rpc/web/request.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 RpcInterface\r\n */\r\n\r\nimport {\r\n  BentleyStatus,\r\n  HttpServerRequest,\r\n  IModelError,\r\n  MarshalingBinaryMarker,\r\n  RpcContentType,\r\n  RpcMultipart,\r\n  RpcResponseCacheControl,\r\n  RpcSerializedValue,\r\n  SerializedRpcActivity,\r\n  SerializedRpcOperation,\r\n  SerializedRpcRequest,\r\n  WEB_RPC_CONSTANTS,\r\n  WebAppRpcProtocol,\r\n} from \"@itwin/core-common\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\nfunction parseHeaders(protocol: WebAppRpcProtocol, req: HttpServerRequest): SerializedRpcActivity {\r\n  const headerNames: SerializedRpcActivity = protocol.serializedClientRequestContextHeaderNames;\r\n  const parsedHeaders: SerializedRpcActivity = {\r\n    id: req.header(headerNames.id) || \"\",\r\n    applicationId: req.header(headerNames.applicationId) || \"\",\r\n    applicationVersion: req.header(headerNames.applicationVersion) || \"\",\r\n    sessionId: req.header(headerNames.sessionId) || \"\",\r\n    authorization: (headerNames.authorization ? req.header(headerNames.authorization) : \"\") ?? \"\",\r\n  };\r\n  return parsedHeaders;\r\n}\r\n\r\nfunction parseFromPath(operation: SerializedRpcOperation): RpcSerializedValue {\r\n  const decoded = operation.encodedRequest ? Buffer.from(operation.encodedRequest, \"base64\").toString(\"binary\") : \"\";\r\n  return RpcSerializedValue.create(decoded);\r\n}\r\n\r\nasync function parseFromBody(req: HttpServerRequest): Promise<RpcSerializedValue> {\r\n  const contentType = WebAppRpcProtocol.computeContentType(req.header(WEB_RPC_CONSTANTS.CONTENT));\r\n  if (contentType === RpcContentType.Binary) {\r\n    const objects = JSON.stringify([MarshalingBinaryMarker.createDefault()]);\r\n    const data = [req.body as Buffer];\r\n    return RpcSerializedValue.create(objects, data);\r\n  } else if (contentType === RpcContentType.Multipart) {\r\n    return RpcMultipart.parseRequest(req);\r\n  } else {\r\n    return RpcSerializedValue.create(req.body as string);\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport async function parseRequest(protocol: WebAppRpcProtocol, req: HttpServerRequest): Promise<SerializedRpcRequest> {\r\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\r\n  const operation = protocol.getOperationFromPath(req.url!);\r\n\r\n  const parsedHeaders = parseHeaders(protocol, req);\r\n\r\n  const request: SerializedRpcRequest = {\r\n    ...parsedHeaders,\r\n    operation: {\r\n      interfaceDefinition: operation.interfaceDefinition,\r\n      operationName: operation.operationName,\r\n      interfaceVersion: operation.interfaceVersion,\r\n    },\r\n    method: req.method,\r\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\r\n    path: req.url!,\r\n    parameters: operation.encodedRequest ? parseFromPath(operation) : await parseFromBody(req),\r\n    caching: operation.encodedRequest ? RpcResponseCacheControl.Immutable : RpcResponseCacheControl.None,\r\n  };\r\n\r\n  request.ip = req.ip;\r\n\r\n  request.protocolVersion = 0;\r\n\r\n  if (protocol.protocolVersionHeaderName) {\r\n    const version = req.header(protocol.protocolVersionHeaderName);\r\n    if (version) {\r\n      request.protocolVersion = parseInt(version, 10);\r\n    }\r\n  }\r\n\r\n  if (!request.id) {\r\n    throw new IModelError(BentleyStatus.ERROR, `Invalid request: Missing required activity ID.`);\r\n  }\r\n\r\n  return request;\r\n}\r\n"]}
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../../../../src/rpc/web/request.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 RpcInterface\r\n */\r\n\r\nimport {\r\n  BentleyStatus,\r\n  HttpServerRequest,\r\n  IModelError,\r\n  MarshalingBinaryMarker,\r\n  RpcContentType,\r\n  RpcMultipart,\r\n  RpcResponseCacheControl,\r\n  RpcSerializedValue,\r\n  SerializedRpcActivity,\r\n  SerializedRpcOperation,\r\n  SerializedRpcRequest,\r\n  WEB_RPC_CONSTANTS,\r\n  WebAppRpcProtocol,\r\n} from \"@itwin/core-common\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\nfunction parseHeaders(protocol: WebAppRpcProtocol, req: HttpServerRequest): SerializedRpcActivity {\r\n  const headerNames: SerializedRpcActivity = protocol.serializedClientRequestContextHeaderNames;\r\n  const parsedHeaders: SerializedRpcActivity = {\r\n    id: req.header(headerNames.id) || \"\",\r\n    applicationId: req.header(headerNames.applicationId) || \"\",\r\n    applicationVersion: req.header(headerNames.applicationVersion) || \"\",\r\n    sessionId: req.header(headerNames.sessionId) || \"\",\r\n    authorization: (headerNames.authorization ? req.header(headerNames.authorization) : \"\") ?? \"\",\r\n  };\r\n  return parsedHeaders;\r\n}\r\n\r\nfunction parseFromPath(operation: SerializedRpcOperation): RpcSerializedValue {\r\n  const decoded = operation.encodedRequest ? Buffer.from(operation.encodedRequest, \"base64\").toString(\"binary\") : \"\";\r\n  return RpcSerializedValue.create(decoded);\r\n}\r\n\r\nasync function parseFromBody(req: HttpServerRequest): Promise<RpcSerializedValue> {\r\n  const contentType = WebAppRpcProtocol.computeContentType(req.header(WEB_RPC_CONSTANTS.CONTENT));\r\n  if (contentType === RpcContentType.Binary) {\r\n    const objects = JSON.stringify([MarshalingBinaryMarker.createDefault()]);\r\n    const data = [req.body as Buffer];\r\n    return RpcSerializedValue.create(objects, data);\r\n  } else if (contentType === RpcContentType.Multipart) {\r\n    return RpcMultipart.parseRequest(req);\r\n  } else {\r\n    return RpcSerializedValue.create(req.body as string);\r\n  }\r\n}\r\n\r\n/** @internal */\r\nexport async function parseRequest(protocol: WebAppRpcProtocol, req: HttpServerRequest): Promise<SerializedRpcRequest> {\r\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\r\n  const operation = protocol.getOperationFromPath(req.url!);\r\n\r\n  const parsedHeaders = parseHeaders(protocol, req);\r\n\r\n  const request: SerializedRpcRequest = {\r\n    ...parsedHeaders,\r\n    operation: {\r\n      interfaceDefinition: operation.interfaceDefinition,\r\n      operationName: operation.operationName,\r\n      interfaceVersion: operation.interfaceVersion,\r\n    },\r\n    method: req.method,\r\n    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\r\n    path: req.url!,\r\n    parameters: operation.encodedRequest ? parseFromPath(operation) : await parseFromBody(req),\r\n    caching: operation.encodedRequest ? RpcResponseCacheControl.Immutable : RpcResponseCacheControl.None,\r\n  };\r\n\r\n  request.ip = req.ip;\r\n\r\n  request.protocolVersion = 0;\r\n\r\n  if (protocol.protocolVersionHeaderName) {\r\n    const version = req.header(protocol.protocolVersionHeaderName);\r\n    if (version) {\r\n      request.protocolVersion = parseInt(version, 10);\r\n    }\r\n  }\r\n\r\n  if (!request.id) {\r\n    throw new IModelError(BentleyStatus.ERROR, `Invalid request: Missing required activity ID.`);\r\n  }\r\n\r\n  return request;\r\n}\r\n"]}

package/lib/cjs/rpc/web/response.js

@@ -65,7 +65,6 @@ function configureStream(fulfillment) {
 }
 /** @internal */
 async function sendResponse(protocol, request, fulfillment, req, res) {
-    var _a;
     const versionHeader = protocol.protocolVersionHeaderName;
     if (versionHeader && core_common_1.RpcProtocol.protocolVersion) {
         res.set(versionHeader, core_common_1.RpcProtocol.protocolVersion.toString());
@@ -89,7 +88,7 @@ async function sendResponse(protocol, request, fulfillment, req, res) {
     }
     configureResponse(protocol, request, fulfillment, res);
     res.status(fulfillment.status);
-    if (fulfillment.allowCompression && ((_a = req.header("Accept-Encoding")) === null || _a === void 0 ? void 0 : _a.includes("gzip"))) {
+    if (fulfillment.allowCompression && req.header("Accept-Encoding")?.includes("gzip")) {
         res.set("Content-Encoding", "gzip");
         const readableResponseBody = (responseBody instanceof Stream) ? responseBody : Readable.from(responseBody);
         responseBody = readableResponseBody.pipe(createGzip());

package/lib/cjs/rpc/web/response.js.map

@@ -1 +1 @@
-{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../src/rpc/web/response.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 RpcInterface\r\n */\r\n\r\nimport {\r\n  HttpServerRequest,\r\n  HttpServerResponse,\r\n  ReadableFormData,\r\n  RpcContentType,\r\n  RpcMultipart,\r\n  RpcProtocol,\r\n  RpcRequestFulfillment,\r\n  RpcRequestStatus,\r\n  RpcResponseCacheControl,\r\n  SerializedRpcRequest,\r\n  WEB_RPC_CONSTANTS,\r\n  WebAppRpcProtocol,\r\n  WebAppRpcRequest,\r\n} from \"@itwin/core-common\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\nfunction configureResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, res: HttpServerResponse) {\r\n  const success = protocol.getStatus(fulfillment.status) === RpcRequestStatus.Resolved;\r\n  // TODO: Use stale-while-revalidate in cache headers. This needs to be tested, and does not currently have support in the router/caching-service.\r\n  // This will allow browsers to use stale cached responses while also revalidating with the router, allowing us to start up a backend if necessary.\r\n\r\n  // RPC Caching Service uses the s-maxage header to determine the TTL for the redis cache.\r\n  const oneHourInSeconds = 3600;\r\n  if (success && request.caching === RpcResponseCacheControl.Immutable) {\r\n    // If response size is > 50 MB, do not cache it.\r\n    if (fulfillment.result.objects.length > (50 * 10 ** 7)) {\r\n      res.set(\"Cache-Control\", \"no-store\");\r\n    } else if (request.operation.operationName === \"generateTileContent\") {\r\n      res.set(\"Cache-Control\", \"no-store\");\r\n    } else if (request.operation.operationName === \"getConnectionProps\") {\r\n      // GetConnectionprops can't be cached on the browser longer than the lifespan of the backend. The lifespan of backend may shrink too. Keep it at 1 second to be safe.\r\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 24}, max-age=1, immutable`);\r\n    } else if (request.operation.operationName === \"getTileCacheContainerUrl\") {\r\n      // getTileCacheContainerUrl returns a SAS with an expiry of 23:59:59. We can't exceed that time when setting the max-age.\r\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 23}, max-age=${oneHourInSeconds * 23}, immutable`);\r\n    } else {\r\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 24}, max-age=${oneHourInSeconds * 48}, immutable`);\r\n    }\r\n  }\r\n\r\n  if (fulfillment.retry) {\r\n    res.set(\"Retry-After\", fulfillment.retry);\r\n  }\r\n}\r\n\r\nfunction configureText(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): string {\r\n  res.set(WEB_RPC_CONSTANTS.CONTENT, WEB_RPC_CONSTANTS.TEXT);\r\n  return (fulfillment.status === 204) ? \"\" : fulfillment.result.objects;\r\n}\r\n\r\nfunction configureBinary(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): Buffer {\r\n  res.set(WEB_RPC_CONSTANTS.CONTENT, WEB_RPC_CONSTANTS.BINARY);\r\n  const data = fulfillment.result.data[0];\r\n  return Buffer.isBuffer(data) ? data : Buffer.from(data);\r\n}\r\n\r\nfunction configureMultipart(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): ReadableFormData {\r\n  const response = RpcMultipart.createStream(fulfillment.result);\r\n  const headers = response.getHeaders();\r\n  for (const header in headers) {\r\n    if (headers.hasOwnProperty(header)) {\r\n      res.set(header, headers[header]);\r\n    }\r\n  }\r\n\r\n  return response;\r\n}\r\n\r\nfunction configureStream(fulfillment: RpcRequestFulfillment) {\r\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\r\n  return fulfillment.result.stream!;\r\n}\r\n\r\n/** @internal */\r\nexport async function sendResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, req: HttpServerRequest, res: HttpServerResponse) {\r\n  const versionHeader = protocol.protocolVersionHeaderName;\r\n  if (versionHeader && RpcProtocol.protocolVersion) {\r\n    res.set(versionHeader, RpcProtocol.protocolVersion.toString());\r\n  }\r\n  // eslint-disable-next-line @typescript-eslint/naming-convention\r\n  const { Readable, Stream } = await import(/* webpackIgnore: true */ \"stream\");\r\n  const { createGzip } = await import(/* webpackIgnore: true */ \"zlib\");\r\n\r\n  const transportType = WebAppRpcRequest.computeTransportType(fulfillment.result, fulfillment.rawResult);\r\n  let responseBody;\r\n  if (transportType === RpcContentType.Binary) {\r\n    responseBody = configureBinary(fulfillment, res);\r\n  } else if (transportType === RpcContentType.Multipart) {\r\n    responseBody = configureMultipart(fulfillment, res);\r\n  } else if (transportType === RpcContentType.Stream) {\r\n    responseBody = configureStream(fulfillment);\r\n  } else {\r\n    responseBody = configureText(fulfillment, res);\r\n  }\r\n\r\n  configureResponse(protocol, request, fulfillment, res);\r\n  res.status(fulfillment.status);\r\n\r\n  if (fulfillment.allowCompression && req.header(\"Accept-Encoding\")?.includes(\"gzip\")) {\r\n    res.set(\"Content-Encoding\", \"gzip\");\r\n    const readableResponseBody = (responseBody instanceof Stream) ? responseBody : Readable.from(responseBody);\r\n    responseBody = readableResponseBody.pipe(createGzip());\r\n  }\r\n\r\n  // This check should in theory look for instances of Readable, but that would break backend implementation at\r\n  // core/backend/src/RpcBackend.ts\r\n  if (responseBody instanceof Stream) {\r\n    responseBody.pipe(res);\r\n  } else {\r\n    res.send(responseBody);\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../../../../src/rpc/web/response.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 RpcInterface\r\n */\r\n\r\nimport {\r\n  HttpServerRequest,\r\n  HttpServerResponse,\r\n  ReadableFormData,\r\n  RpcContentType,\r\n  RpcMultipart,\r\n  RpcProtocol,\r\n  RpcRequestFulfillment,\r\n  RpcRequestStatus,\r\n  RpcResponseCacheControl,\r\n  SerializedRpcRequest,\r\n  WEB_RPC_CONSTANTS,\r\n  WebAppRpcProtocol,\r\n  WebAppRpcRequest,\r\n} from \"@itwin/core-common\";\r\n\r\n/* eslint-disable deprecation/deprecation */\r\n\r\nfunction configureResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, res: HttpServerResponse) {\r\n  const success = protocol.getStatus(fulfillment.status) === RpcRequestStatus.Resolved;\r\n  // TODO: Use stale-while-revalidate in cache headers. This needs to be tested, and does not currently have support in the router/caching-service.\r\n  // This will allow browsers to use stale cached responses while also revalidating with the router, allowing us to start up a backend if necessary.\r\n\r\n  // RPC Caching Service uses the s-maxage header to determine the TTL for the redis cache.\r\n  const oneHourInSeconds = 3600;\r\n  if (success && request.caching === RpcResponseCacheControl.Immutable) {\r\n    // If response size is > 50 MB, do not cache it.\r\n    if (fulfillment.result.objects.length > (50 * 10 ** 7)) {\r\n      res.set(\"Cache-Control\", \"no-store\");\r\n    } else if (request.operation.operationName === \"generateTileContent\") {\r\n      res.set(\"Cache-Control\", \"no-store\");\r\n    } else if (request.operation.operationName === \"getConnectionProps\") {\r\n      // GetConnectionprops can't be cached on the browser longer than the lifespan of the backend. The lifespan of backend may shrink too. Keep it at 1 second to be safe.\r\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 24}, max-age=1, immutable`);\r\n    } else if (request.operation.operationName === \"getTileCacheContainerUrl\") {\r\n      // getTileCacheContainerUrl returns a SAS with an expiry of 23:59:59. We can't exceed that time when setting the max-age.\r\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 23}, max-age=${oneHourInSeconds * 23}, immutable`);\r\n    } else {\r\n      res.set(\"Cache-Control\", `s-maxage=${oneHourInSeconds * 24}, max-age=${oneHourInSeconds * 48}, immutable`);\r\n    }\r\n  }\r\n\r\n  if (fulfillment.retry) {\r\n    res.set(\"Retry-After\", fulfillment.retry);\r\n  }\r\n}\r\n\r\nfunction configureText(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): string {\r\n  res.set(WEB_RPC_CONSTANTS.CONTENT, WEB_RPC_CONSTANTS.TEXT);\r\n  return (fulfillment.status === 204) ? \"\" : fulfillment.result.objects;\r\n}\r\n\r\nfunction configureBinary(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): Buffer {\r\n  res.set(WEB_RPC_CONSTANTS.CONTENT, WEB_RPC_CONSTANTS.BINARY);\r\n  const data = fulfillment.result.data[0];\r\n  return Buffer.isBuffer(data) ? data : Buffer.from(data);\r\n}\r\n\r\nfunction configureMultipart(fulfillment: RpcRequestFulfillment, res: HttpServerResponse): ReadableFormData {\r\n  const response = RpcMultipart.createStream(fulfillment.result);\r\n  const headers = response.getHeaders();\r\n  for (const header in headers) {\r\n    if (headers.hasOwnProperty(header)) {\r\n      res.set(header, headers[header]);\r\n    }\r\n  }\r\n\r\n  return response;\r\n}\r\n\r\nfunction configureStream(fulfillment: RpcRequestFulfillment) {\r\n  // eslint-disable-next-line @typescript-eslint/no-non-null-assertion\r\n  return fulfillment.result.stream!;\r\n}\r\n\r\n/** @internal */\r\nexport async function sendResponse(protocol: WebAppRpcProtocol, request: SerializedRpcRequest, fulfillment: RpcRequestFulfillment, req: HttpServerRequest, res: HttpServerResponse) {\r\n  const versionHeader = protocol.protocolVersionHeaderName;\r\n  if (versionHeader && RpcProtocol.protocolVersion) {\r\n    res.set(versionHeader, RpcProtocol.protocolVersion.toString());\r\n  }\r\n  // eslint-disable-next-line @typescript-eslint/naming-convention\r\n  const { Readable, Stream } = await import(/* webpackIgnore: true */ \"stream\");\r\n  const { createGzip } = await import(/* webpackIgnore: true */ \"zlib\");\r\n\r\n  const transportType = WebAppRpcRequest.computeTransportType(fulfillment.result, fulfillment.rawResult);\r\n  let responseBody;\r\n  if (transportType === RpcContentType.Binary) {\r\n    responseBody = configureBinary(fulfillment, res);\r\n  } else if (transportType === RpcContentType.Multipart) {\r\n    responseBody = configureMultipart(fulfillment, res);\r\n  } else if (transportType === RpcContentType.Stream) {\r\n    responseBody = configureStream(fulfillment);\r\n  } else {\r\n    responseBody = configureText(fulfillment, res);\r\n  }\r\n\r\n  configureResponse(protocol, request, fulfillment, res);\r\n  res.status(fulfillment.status);\r\n\r\n  if (fulfillment.allowCompression && req.header(\"Accept-Encoding\")?.includes(\"gzip\")) {\r\n    res.set(\"Content-Encoding\", \"gzip\");\r\n    const readableResponseBody = (responseBody instanceof Stream) ? responseBody : Readable.from(responseBody);\r\n    responseBody = readableResponseBody.pipe(createGzip());\r\n  }\r\n\r\n  // This check should in theory look for instances of Readable, but that would break backend implementation at\r\n  // core/backend/src/RpcBackend.ts\r\n  if (responseBody instanceof Stream) {\r\n    responseBody.pipe(res);\r\n  } else {\r\n    res.send(responseBody);\r\n  }\r\n}\r\n"]}

package/lib/cjs/rpc-impl/IModelReadRpcImpl.d.ts

@@ -35,7 +35,7 @@ export declare class IModelReadRpcImpl extends RpcInterface implements IModelRea
     getMassPropertiesPerCandidate(tokenProps: IModelRpcProps, props: MassPropertiesPerCandidateRequestProps): Promise<MassPropertiesPerCandidateResponseProps[]>;
     getToolTipMessage(tokenProps: IModelRpcProps, id: string): Promise<string[]>;
     /** Send a view thumbnail to the frontend. This is a binary transfer with the metadata in a 16-byte prefix header.
-     * @deprecated in 3.x.
+     * @deprecated in 3.x with no replacement; thumbnails are rarely added to the iModel.
      */
     getViewThumbnail(_tokenProps: IModelRpcProps, _viewId: string): Promise<Uint8Array>;
     getDefaultViewId(tokenProps: IModelRpcProps): Promise<Id64String>;

package/lib/cjs/rpc-impl/IModelReadRpcImpl.js

@@ -27,10 +27,9 @@ class ViewStateRequestMemoizer extends PromiseMemoizer_1.PromiseMemoizer {
             return viewCreator.getCustomViewState3dData(props.options);
         };
         const stringify = (props) => {
-            var _a;
             const token = props.tokenProps;
             const modelIds = props.options.modelIds;
-            return `${token.key}-${token.iTwinId}-${token.iModelId}-${(_a = token.changeset) === null || _a === void 0 ? void 0 : _a.id}:${modelIds}`;
+            return `${token.key}-${token.iTwinId}-${token.iModelId}-${token.changeset?.id}:${modelIds}`;
         };
         super(memoize, stringify);
         this._timeoutMs = 20 * 1000;
@@ -248,7 +247,7 @@ class IModelReadRpcImpl extends core_common_1.RpcInterface {
         return (el === undefined) ? [] : el.getToolTipMessage();
     }
     /** Send a view thumbnail to the frontend. This is a binary transfer with the metadata in a 16-byte prefix header.
-     * @deprecated in 3.x.
+     * @deprecated in 3.x with no replacement; thumbnails are rarely added to the iModel.
      */
     async getViewThumbnail(_tokenProps, _viewId) {
         const iModelDb = await RpcBriefcaseUtility_1.RpcBriefcaseUtility.findOpenIModel(currentActivity().accessToken, _tokenProps);