@itwin/core-backend 3.4.0-dev.9 → 3.4.1

package/lib/cjs/ElementAspect.js

@@ -1,179 +1,187 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module ElementAspects
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExternalSourceAspect = exports.ChannelRootAspect = exports.ElementMultiAspect = exports.ElementUniqueAspect = exports.ElementAspect = void 0;
-const core_common_1 = require("@itwin/core-common");
-const Entity_1 = require("./Entity");
-const core_bentley_1 = require("@itwin/core-bentley");
-/** An Element Aspect is a class that defines a set of properties that are related to (and owned by) a single element.
- * Semantically, an ElementAspect can be considered part of the Element. Thus, an ElementAspect is deleted if its owning Element is deleted.
- * BIS Guideline: Subclass ElementUniqueAspect or ElementMultiAspect rather than subclassing ElementAspect directly.
- * @public
- */
-class ElementAspect extends Entity_1.Entity {
-    /** @internal */
-    constructor(props, iModel) {
-        super(props, iModel);
-        this.element = core_common_1.RelatedElement.fromJSON(props.element); // eslint-disable-line @typescript-eslint/no-non-null-assertion
-    }
-    /** @internal */
-    static get className() { return "ElementAspect"; }
-    /** @internal */
-    toJSON() {
-        const val = super.toJSON();
-        val.element = this.element;
-        return val;
-    }
-    /** Called before a new ElementAspect is inserted.
-     * @note throw an exception to disallow the insert
-     * @note If you override this method, you must call super.
-     * @beta
-     */
-    static onInsert(_arg) { }
-    /** Called after a new ElementAspect was inserted.
-     * @note If you override this method, you must call super.
-     * @beta
-     */
-    static onInserted(_arg) { }
-    /** Called before an ElementAspect is updated.
-     * @note throw an exception to disallow the update
-     * @note If you override this method, you must call super.
-     * @beta
-     */
-    static onUpdate(_arg) { }
-    /** Called after an ElementAspect was updated.
-     * @note If you override this method, you must call super.
-     * @beta
-     */
-    static onUpdated(_arg) { }
-    /** Called before an ElementAspect is deleted.
-     * @note throw an exception to disallow the delete
-     * @note If you override this method, you must call super.
-     * @beta
-     */
-    static onDelete(_arg) { }
-    /** Called after an ElementAspect was deleted.
-     * @note If you override this method, you must call super.
-     * @beta
-     */
-    static onDeleted(_arg) { }
-}
-exports.ElementAspect = ElementAspect;
-/** An Element Unique Aspect is an ElementAspect where there can be only zero or one instance of the Element Aspect class per Element.
- * @public
- */
-class ElementUniqueAspect extends ElementAspect {
-    /** @internal */
-    static get className() { return "ElementUniqueAspect"; }
-}
-exports.ElementUniqueAspect = ElementUniqueAspect;
-/** An Element Multi-Aspect is an ElementAspect where there can be **n** instances of the Element Aspect class per Element.
- * @public
- */
-class ElementMultiAspect extends ElementAspect {
-    /** @internal */
-    static get className() { return "ElementMultiAspect"; }
-}
-exports.ElementMultiAspect = ElementMultiAspect;
-/** A ChannelRootAspect identifies an Element as the root of a *channel* which is a subset of the overall iModel hierarchy that is independently maintained.
- * @note The associated ECClass was added to the BisCore schema in version 1.0.10
- * @public
- */
-class ChannelRootAspect extends ElementUniqueAspect {
-    /** @internal */
-    constructor(props, iModel) {
-        super(props, iModel);
-        this.owner = props.owner;
-    }
-    /** @internal */
-    static get className() { return "ChannelRootAspect"; }
-    /** @internal */
-    toJSON() {
-        const val = super.toJSON();
-        val.owner = this.owner;
-        return val;
-    }
-    /** Insert a ChannelRootAspect on the specified element. */
-    static insert(iModel, ownerId, ownerDescription) {
-        const props = {
-            classFullName: ChannelRootAspect.classFullName,
-            element: { id: ownerId },
-            owner: ownerDescription,
-        };
-        iModel.elements.insertAspect(props);
-    }
-}
-exports.ChannelRootAspect = ChannelRootAspect;
-/** An ElementMultiAspect that stores synchronization information for an Element originating from an external source.
- * @note The associated ECClass was added to the BisCore schema in version 1.0.2
- * @public
- */
-class ExternalSourceAspect extends ElementMultiAspect {
-    /** @internal */
-    constructor(props, iModel) {
-        super(props, iModel);
-        this.scope = core_common_1.RelatedElement.fromJSON(props.scope); // eslint-disable-line @typescript-eslint/no-non-null-assertion
-        this.source = core_common_1.RelatedElement.fromJSON(props.source);
-        this.identifier = props.identifier;
-        this.kind = props.kind;
-        this.checksum = props.checksum;
-        this.version = props.version;
-        this.jsonProperties = props.jsonProperties;
-    }
-    /** @internal */
-    static get className() { return "ExternalSourceAspect"; }
-    /**  Look up the ElementId of the element that contains an aspect with the specified Scope, Kind, and Identifier
-     */
-    static findBySource(iModelDb, scope, kind, identifier) {
-        const sql = `SELECT Element.Id, ECInstanceId FROM ${ExternalSourceAspect.classFullName} WHERE (Scope.Id=:scope AND Kind=:kind AND Identifier=:identifier)`;
-        let elementId;
-        let aspectId;
-        iModelDb.withPreparedStatement(sql, (statement) => {
-            statement.bindId("scope", scope);
-            statement.bindString("kind", kind);
-            statement.bindString("identifier", identifier);
-            if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
-                elementId = statement.getValue(0).getId();
-                aspectId = statement.getValue(1).getId();
-            }
-        });
-        return { elementId, aspectId };
-    }
-    /** @internal */
-    toJSON() {
-        const val = super.toJSON();
-        val.scope = this.scope;
-        val.source = this.source;
-        val.identifier = this.identifier;
-        val.kind = this.kind;
-        val.checksum = this.checksum;
-        val.version = this.version;
-        val.jsonProperties = this.jsonProperties;
-        return val;
-    }
-}
-exports.ExternalSourceAspect = ExternalSourceAspect;
-/** @public */
-(function (ExternalSourceAspect) {
-    /** Standard values for the `Kind` property of `ExternalSourceAspect`.
-     * @public
-     */
-    let Kind;
-    (function (Kind) {
-        /** Indicates that the [[ExternalSourceAspect]] is storing [[Element]] provenance */
-        Kind["Element"] = "Element";
-        /** Indicates that the [[ExternalSourceAspect]] is storing [[Relationship]] provenance */
-        Kind["Relationship"] = "Relationship";
-        /** Indicates that the [[ExternalSourceAspect]] is storing *scope* provenance
-         * @see [[ExternalSourceAspect.scope]]
-         */
-        Kind["Scope"] = "Scope";
-    })(Kind = ExternalSourceAspect.Kind || (ExternalSourceAspect.Kind = {}));
-})(ExternalSourceAspect = exports.ExternalSourceAspect || (exports.ExternalSourceAspect = {}));
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module ElementAspects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExternalSourceAspect = exports.ChannelRootAspect = exports.ElementMultiAspect = exports.ElementUniqueAspect = exports.ElementAspect = void 0;
+const core_common_1 = require("@itwin/core-common");
+const Entity_1 = require("./Entity");
+const core_bentley_1 = require("@itwin/core-bentley");
+/** An Element Aspect is a class that defines a set of properties that are related to (and owned by) a single element.
+ * Semantically, an ElementAspect can be considered part of the Element. Thus, an ElementAspect is deleted if its owning Element is deleted.
+ * BIS Guideline: Subclass ElementUniqueAspect or ElementMultiAspect rather than subclassing ElementAspect directly.
+ * @public
+ */
+class ElementAspect extends Entity_1.Entity {
+    /** @internal */
+    constructor(props, iModel) {
+        super(props, iModel);
+        this.element = core_common_1.RelatedElement.fromJSON(props.element); // eslint-disable-line @typescript-eslint/no-non-null-assertion
+    }
+    /** @internal */
+    static get className() { return "ElementAspect"; }
+    /** @internal */
+    toJSON() {
+        const val = super.toJSON();
+        val.element = this.element;
+        return val;
+    }
+    /** Called before a new ElementAspect is inserted.
+     * @note throw an exception to disallow the insert
+     * @note If you override this method, you must call super.
+     * @beta
+     */
+    static onInsert(_arg) { }
+    /** Called after a new ElementAspect was inserted.
+     * @note If you override this method, you must call super.
+     * @beta
+     */
+    static onInserted(_arg) { }
+    /** Called before an ElementAspect is updated.
+     * @note throw an exception to disallow the update
+     * @note If you override this method, you must call super.
+     * @beta
+     */
+    static onUpdate(_arg) { }
+    /** Called after an ElementAspect was updated.
+     * @note If you override this method, you must call super.
+     * @beta
+     */
+    static onUpdated(_arg) { }
+    /** Called before an ElementAspect is deleted.
+     * @note throw an exception to disallow the delete
+     * @note If you override this method, you must call super.
+     * @beta
+     */
+    static onDelete(_arg) { }
+    /** Called after an ElementAspect was deleted.
+     * @note If you override this method, you must call super.
+     * @beta
+     */
+    static onDeleted(_arg) { }
+}
+exports.ElementAspect = ElementAspect;
+/** An Element Unique Aspect is an ElementAspect where there can be only zero or one instance of the Element Aspect class per Element.
+ * @public
+ */
+class ElementUniqueAspect extends ElementAspect {
+    /** @internal */
+    static get className() { return "ElementUniqueAspect"; }
+}
+exports.ElementUniqueAspect = ElementUniqueAspect;
+/** An Element Multi-Aspect is an ElementAspect where there can be **n** instances of the Element Aspect class per Element.
+ * @public
+ */
+class ElementMultiAspect extends ElementAspect {
+    /** @internal */
+    static get className() { return "ElementMultiAspect"; }
+}
+exports.ElementMultiAspect = ElementMultiAspect;
+/** A ChannelRootAspect identifies an Element as the root of a *channel* which is a subset of the overall iModel hierarchy that is independently maintained.
+ * @note The associated ECClass was added to the BisCore schema in version 1.0.10
+ * @public
+ */
+class ChannelRootAspect extends ElementUniqueAspect {
+    /** @internal */
+    constructor(props, iModel) {
+        super(props, iModel);
+        this.owner = props.owner;
+    }
+    /** @internal */
+    static get className() { return "ChannelRootAspect"; }
+    /** @internal */
+    toJSON() {
+        const val = super.toJSON();
+        val.owner = this.owner;
+        return val;
+    }
+    /** Insert a ChannelRootAspect on the specified element. */
+    static insert(iModel, ownerId, ownerDescription) {
+        const props = {
+            classFullName: ChannelRootAspect.classFullName,
+            element: { id: ownerId },
+            owner: ownerDescription,
+        };
+        iModel.elements.insertAspect(props);
+    }
+}
+exports.ChannelRootAspect = ChannelRootAspect;
+/** An ElementMultiAspect that stores synchronization information for an Element originating from an external source.
+ * @note The associated ECClass was added to the BisCore schema in version 1.0.2
+ * @public
+ */
+class ExternalSourceAspect extends ElementMultiAspect {
+    /** @internal */
+    constructor(props, iModel) {
+        super(props, iModel);
+        this.scope = core_common_1.RelatedElement.fromJSON(props.scope); // eslint-disable-line @typescript-eslint/no-non-null-assertion
+        this.source = core_common_1.RelatedElement.fromJSON(props.source);
+        this.identifier = props.identifier;
+        this.kind = props.kind;
+        this.checksum = props.checksum;
+        this.version = props.version;
+        this.jsonProperties = props.jsonProperties;
+    }
+    /** @internal */
+    static get className() { return "ExternalSourceAspect"; }
+    /**  Look up the ElementId of the element that contains an aspect with the specified Scope, Kind, and Identifier
+     */
+    static findBySource(iModelDb, scope, kind, identifier) {
+        const sql = `SELECT Element.Id, ECInstanceId FROM ${ExternalSourceAspect.classFullName} WHERE (Scope.Id=:scope AND Kind=:kind AND Identifier=:identifier)`;
+        let elementId;
+        let aspectId;
+        iModelDb.withPreparedStatement(sql, (statement) => {
+            statement.bindId("scope", scope);
+            statement.bindString("kind", kind);
+            statement.bindString("identifier", identifier);
+            if (core_bentley_1.DbResult.BE_SQLITE_ROW === statement.step()) {
+                elementId = statement.getValue(0).getId();
+                aspectId = statement.getValue(1).getId();
+            }
+        });
+        return { elementId, aspectId };
+    }
+    /** @internal */
+    toJSON() {
+        const val = super.toJSON();
+        val.scope = this.scope;
+        val.source = this.source;
+        val.identifier = this.identifier;
+        val.kind = this.kind;
+        val.checksum = this.checksum;
+        val.version = this.version;
+        val.jsonProperties = this.jsonProperties;
+        return val;
+    }
+    /** @internal */
+    collectReferenceConcreteIds(referenceIds) {
+        super.collectReferenceConcreteIds(referenceIds);
+        referenceIds.addElement(this.scope.id);
+        referenceIds.addElement(this.element.id);
+        if (this.source)
+            referenceIds.addElement(this.source.id);
+    }
+}
+exports.ExternalSourceAspect = ExternalSourceAspect;
+/** @public */
+(function (ExternalSourceAspect) {
+    /** Standard values for the `Kind` property of `ExternalSourceAspect`.
+     * @public
+     */
+    let Kind;
+    (function (Kind) {
+        /** Indicates that the [[ExternalSourceAspect]] is storing [[Element]] provenance */
+        Kind["Element"] = "Element";
+        /** Indicates that the [[ExternalSourceAspect]] is storing [[Relationship]] provenance */
+        Kind["Relationship"] = "Relationship";
+        /** Indicates that the [[ExternalSourceAspect]] is storing *scope* provenance
+         * @see [[ExternalSourceAspect.scope]]
+         */
+        Kind["Scope"] = "Scope";
+    })(Kind = ExternalSourceAspect.Kind || (ExternalSourceAspect.Kind = {}));
+})(ExternalSourceAspect = exports.ExternalSourceAspect || (exports.ExternalSourceAspect = {}));
 //# sourceMappingURL=ElementAspect.js.map

package/lib/cjs/ElementAspect.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElementAspect.js","sourceRoot":"","sources":["../../src/ElementAspect.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,oDAA2H;AAC3H,qCAAkC;AAGlC,sDAA2D;AAwB3D;;;;GAIG;AACH,MAAa,aAAc,SAAQ,eAAM;IAKvC,gBAAgB;IAChB,YAAY,KAAyB,EAAE,MAAgB;QACrD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,4BAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAE,CAAC,CAAC,+DAA+D;IACzH,CAAC;IARD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,eAAe,CAAC,CAAC,CAAC;IAS1E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAAwB,CAAC;QACjD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;OAIG;IACO,MAAM,CAAC,QAAQ,CAAC,IAAsB,IAAU,CAAC;IAE3D;;;OAGG;IACO,MAAM,CAAC,UAAU,CAAC,IAAsB,IAAU,CAAC;IAE7D;;;;OAIG;IACO,MAAM,CAAC,QAAQ,CAAC,IAAsB,IAAU,CAAC;IAE3D;;;OAGG;IACO,MAAM,CAAC,SAAS,CAAC,IAAsB,IAAU,CAAC;IAE5D;;;;OAIG;IACO,MAAM,CAAC,QAAQ,CAAC,IAAmB,IAAU,CAAC;IAExD;;;OAGG;IACO,MAAM,CAAC,SAAS,CAAC,IAAmB,IAAU,CAAC;CAC1D;AAxDD,sCAwDC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,aAAa;IACpD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,qBAAqB,CAAC,CAAC,CAAC;CACjF;AAHD,kDAGC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,aAAa;IACnD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,oBAAoB,CAAC,CAAC,CAAC;CAChF;AAHD,gDAGC;AAED;;;GAGG;AACH,MAAa,iBAAkB,SAAQ,mBAAmB;IAOxD,gBAAgB;IAChB,YAAY,KAA6B,EAAE,MAAgB;QACzD,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC3B,CAAC;IAVD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,mBAAmB,CAAC,CAAC,CAAC;IAW9E,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAA4B,CAAC;QACrD,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,2DAA2D;IACpD,MAAM,CAAC,MAAM,CAAC,MAAgB,EAAE,OAAmB,EAAE,gBAAwB;QAClF,MAAM,KAAK,GAA2B;YACpC,aAAa,EAAE,iBAAiB,CAAC,aAAa;YAC9C,OAAO,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE;YACxB,KAAK,EAAE,gBAAgB;SACxB,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IACtC,CAAC;CACF;AA7BD,8CA6BC;AAED;;;GAGG;AACH,MAAa,oBAAqB,SAAQ,kBAAkB;IAsB1D,gBAAgB;IAChB,YAAY,KAAgC,EAAE,MAAgB;QAC5D,KAAK,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,4BAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,CAAC,+DAA+D;QACnH,IAAI,CAAC,MAAM,GAAG,4BAAc,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;IAC7C,CAAC;IA/BD,gBAAgB;IACT,MAAM,KAAc,SAAS,KAAa,OAAO,sBAAsB,CAAC,CAAC,CAAC;IAgCjF;OACG;IACI,MAAM,CAAC,YAAY,CAAC,QAAkB,EAAE,KAAiB,EAAE,IAAY,EAAE,UAAkB;QAChG,MAAM,GAAG,GAAG,wCAAwC,oBAAoB,CAAC,aAAa,oEAAoE,CAAC;QAC3J,IAAI,SAAiC,CAAC;QACtC,IAAI,QAAgC,CAAC;QACrC,QAAQ,CAAC,qBAAqB,CAAC,GAAG,EAAE,CAAC,SAAyB,EAAE,EAAE;YAChE,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACjC,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YACnC,SAAS,CAAC,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;YAC/C,IAAI,uBAAQ,CAAC,aAAa,KAAK,SAAS,CAAC,IAAI,EAAE,EAAE;gBAC/C,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;gBAC1C,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;aAC1C;QACH,CAAC,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC;IAED,gBAAgB;IACA,MAAM;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,EAA+B,CAAC;QACxD,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACvB,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QACjC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7B,GAAG,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3B,GAAG,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QACzC,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAhED,oDAgEC;AAED,cAAc;AACd,WAAiB,oBAAoB;IACnC;;OAEG;IACH,IAAY,IASX;IATD,WAAY,IAAI;QACd,oFAAoF;QACpF,2BAAmB,CAAA;QACnB,yFAAyF;QACzF,qCAA6B,CAAA;QAC7B;;WAEG;QACH,uBAAe,CAAA;IACjB,CAAC,EATW,IAAI,GAAJ,yBAAI,KAAJ,yBAAI,QASf;AACH,CAAC,EAdgB,oBAAoB,GAApB,4BAAoB,KAApB,4BAAoB,QAcpC","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 ElementAspects\r\n */\r\n\r\nimport { ChannelRootAspectProps, ElementAspectProps, ExternalSourceAspectProps, RelatedElement } from \"@itwin/core-common\";\r\nimport { Entity } from \"./Entity\";\r\nimport { IModelDb } from \"./IModelDb\";\r\nimport { ECSqlStatement } from \"./ECSqlStatement\";\r\nimport { DbResult, Id64String } from \"@itwin/core-bentley\";\r\n\r\n/** Argument for the `ElementAspect.onXxx` static methods\r\n * @beta\r\n */\r\nexport interface OnAspectArg {\r\n  /** The iModel for the aspect affected by this event. */\r\n  iModel: IModelDb;\r\n}\r\n/** Argument for the `ElementAspect.onXxx` static methods that supply the properties of an aspect to be inserted or updated.\r\n * @beta\r\n */\r\nexport interface OnAspectPropsArg extends OnAspectArg {\r\n  /** The new properties of the aspect affected by this event. */\r\n  props: Readonly<ElementAspectProps>;\r\n}\r\n/** Argument for the `ElementAspect.onXxx` static methods that only supply the Id of the affected aspect.\r\n * @beta\r\n */\r\nexport interface OnAspectIdArg extends OnAspectArg {\r\n  /** The Id of the aspect affected by this event */\r\n  aspectId: Id64String;\r\n}\r\n\r\n/** An Element Aspect is a class that defines a set of properties that are related to (and owned by) a single element.\r\n * Semantically, an ElementAspect can be considered part of the Element. Thus, an ElementAspect is deleted if its owning Element is deleted.\r\n * BIS Guideline: Subclass ElementUniqueAspect or ElementMultiAspect rather than subclassing ElementAspect directly.\r\n * @public\r\n */\r\nexport class ElementAspect extends Entity {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ElementAspect\"; }\r\n  public element: RelatedElement;\r\n\r\n  /** @internal */\r\n  constructor(props: ElementAspectProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.element = RelatedElement.fromJSON(props.element)!; // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ElementAspectProps {\r\n    const val = super.toJSON() as ElementAspectProps;\r\n    val.element = this.element;\r\n    return val;\r\n  }\r\n\r\n  /** Called before a new ElementAspect is inserted.\r\n   * @note throw an exception to disallow the insert\r\n   * @note If you override this method, you must call super.\r\n   * @beta\r\n   */\r\n  protected static onInsert(_arg: OnAspectPropsArg): void { }\r\n\r\n  /** Called after a new ElementAspect was inserted.\r\n   * @note If you override this method, you must call super.\r\n   * @beta\r\n   */\r\n  protected static onInserted(_arg: OnAspectPropsArg): void { }\r\n\r\n  /** Called before an ElementAspect is updated.\r\n   * @note throw an exception to disallow the update\r\n   * @note If you override this method, you must call super.\r\n   * @beta\r\n   */\r\n  protected static onUpdate(_arg: OnAspectPropsArg): void { }\r\n\r\n  /** Called after an ElementAspect was updated.\r\n   * @note If you override this method, you must call super.\r\n   * @beta\r\n   */\r\n  protected static onUpdated(_arg: OnAspectPropsArg): void { }\r\n\r\n  /** Called before an ElementAspect is deleted.\r\n   * @note throw an exception to disallow the delete\r\n   * @note If you override this method, you must call super.\r\n   * @beta\r\n   */\r\n  protected static onDelete(_arg: OnAspectIdArg): void { }\r\n\r\n  /** Called after an ElementAspect was deleted.\r\n   * @note If you override this method, you must call super.\r\n   * @beta\r\n   */\r\n  protected static onDeleted(_arg: OnAspectIdArg): void { }\r\n}\r\n\r\n/** An Element Unique Aspect is an ElementAspect where there can be only zero or one instance of the Element Aspect class per Element.\r\n * @public\r\n */\r\nexport class ElementUniqueAspect extends ElementAspect {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ElementUniqueAspect\"; }\r\n}\r\n\r\n/** An Element Multi-Aspect is an ElementAspect where there can be **n** instances of the Element Aspect class per Element.\r\n * @public\r\n */\r\nexport class ElementMultiAspect extends ElementAspect {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ElementMultiAspect\"; }\r\n}\r\n\r\n/** A ChannelRootAspect identifies an Element as the root of a *channel* which is a subset of the overall iModel hierarchy that is independently maintained.\r\n * @note The associated ECClass was added to the BisCore schema in version 1.0.10\r\n * @public\r\n */\r\nexport class ChannelRootAspect extends ElementUniqueAspect {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ChannelRootAspect\"; }\r\n\r\n  /** The owner of the channel */\r\n  public owner: string;\r\n\r\n  /** @internal */\r\n  constructor(props: ChannelRootAspectProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.owner = props.owner;\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ChannelRootAspectProps {\r\n    const val = super.toJSON() as ChannelRootAspectProps;\r\n    val.owner = this.owner;\r\n    return val;\r\n  }\r\n\r\n  /** Insert a ChannelRootAspect on the specified element. */\r\n  public static insert(iModel: IModelDb, ownerId: Id64String, ownerDescription: string) {\r\n    const props: ChannelRootAspectProps = {\r\n      classFullName: ChannelRootAspect.classFullName,\r\n      element: { id: ownerId },\r\n      owner: ownerDescription,\r\n    };\r\n    iModel.elements.insertAspect(props);\r\n  }\r\n}\r\n\r\n/** An ElementMultiAspect that stores synchronization information for an Element originating from an external source.\r\n * @note The associated ECClass was added to the BisCore schema in version 1.0.2\r\n * @public\r\n */\r\nexport class ExternalSourceAspect extends ElementMultiAspect {\r\n  /** @internal */\r\n  public static override get className(): string { return \"ExternalSourceAspect\"; }\r\n\r\n  /** An element that scopes the combination of `kind` and `identifier` to uniquely identify the object from the external source. */\r\n  public scope: RelatedElement;\r\n  /** The identifier of the object in the source repository. */\r\n  public identifier: string;\r\n  /** The kind of object within the source repository. */\r\n  public kind: string;\r\n  /** The cryptographic hash (any algorithm) of the source object's content. If defined, it must be guaranteed to change when the source object's content changes. */\r\n  public checksum?: string;\r\n  /** An optional value that is typically a version number or a pseudo version number like last modified time.\r\n   * It will be used by the synchronization process to detect that a source object is unchanged so that computing a cryptographic hash can be avoided.\r\n   * If present, this value must be guaranteed to change when any of the source object's content changes.\r\n   */\r\n  public version?: string;\r\n  /** A place where additional JSON properties can be stored. For example, provenance information or properties relating to the synchronization process. */\r\n  public jsonProperties?: string;\r\n  /** The source of the imported/synchronized object. Should point to an instance of [ExternalSource]($backend). */\r\n  public source?: RelatedElement;\r\n\r\n  /** @internal */\r\n  constructor(props: ExternalSourceAspectProps, iModel: IModelDb) {\r\n    super(props, iModel);\r\n    this.scope = RelatedElement.fromJSON(props.scope)!; // eslint-disable-line @typescript-eslint/no-non-null-assertion\r\n    this.source = RelatedElement.fromJSON(props.source);\r\n    this.identifier = props.identifier;\r\n    this.kind = props.kind;\r\n    this.checksum = props.checksum;\r\n    this.version = props.version;\r\n    this.jsonProperties = props.jsonProperties;\r\n  }\r\n\r\n  /**  Look up the ElementId of the element that contains an aspect with the specified Scope, Kind, and Identifier\r\n   */\r\n  public static findBySource(iModelDb: IModelDb, scope: Id64String, kind: string, identifier: string): { elementId?: Id64String, aspectId?: Id64String } {\r\n    const sql = `SELECT Element.Id, ECInstanceId FROM ${ExternalSourceAspect.classFullName} WHERE (Scope.Id=:scope AND Kind=:kind AND Identifier=:identifier)`;\r\n    let elementId: Id64String | undefined;\r\n    let aspectId: Id64String | undefined;\r\n    iModelDb.withPreparedStatement(sql, (statement: ECSqlStatement) => {\r\n      statement.bindId(\"scope\", scope);\r\n      statement.bindString(\"kind\", kind);\r\n      statement.bindString(\"identifier\", identifier);\r\n      if (DbResult.BE_SQLITE_ROW === statement.step()) {\r\n        elementId = statement.getValue(0).getId();\r\n        aspectId = statement.getValue(1).getId();\r\n      }\r\n    });\r\n    return { elementId, aspectId };\r\n  }\r\n\r\n  /** @internal */\r\n  public override toJSON(): ExternalSourceAspectProps {\r\n    const val = super.toJSON() as ExternalSourceAspectProps;\r\n    val.scope = this.scope;\r\n    val.source = this.source;\r\n    val.identifier = this.identifier;\r\n    val.kind = this.kind;\r\n    val.checksum = this.checksum;\r\n    val.version = this.version;\r\n    val.jsonProperties = this.jsonProperties;\r\n    return val;\r\n  }\r\n}\r\n\r\n/** @public */\r\nexport namespace ExternalSourceAspect { // eslint-disable-line no-redeclare\r\n  /** Standard values for the `Kind` property of `ExternalSourceAspect`.\r\n   * @public\r\n   */\r\n  export enum Kind {\r\n    /** Indicates that the [[ExternalSourceAspect]] is storing [[Element]] provenance */\r\n    Element = \"Element\",\r\n    /** Indicates that the [[ExternalSourceAspect]] is storing [[Relationship]] provenance */\r\n    Relationship = \"Relationship\",\r\n    /** Indicates that the [[ExternalSourceAspect]] is storing *scope* provenance\r\n     * @see [[ExternalSourceAspect.scope]]\r\n     */\r\n    Scope = \"Scope\",\r\n  }\r\n}\r\n"]}
+{"version":3,"file":"ElementAspect.js","sourceRoot":"","sources":["../../src/ElementAspect.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module ElementAspects\n */\n\nimport { ChannelRootAspectProps, ElementAspectProps, EntityReferenceSet, ExternalSourceAspectProps, RelatedElement } from \"@itwin/core-common\";\nimport { Entity } from \"./Entity\";\nimport { IModelDb } from \"./IModelDb\";\nimport { ECSqlStatement } from \"./ECSqlStatement\";\nimport { DbResult, Id64String } from \"@itwin/core-bentley\";\n\n/** Argument for the `ElementAspect.onXxx` static methods\n * @beta\n */\nexport interface OnAspectArg {\n  /** The iModel for the aspect affected by this event. */\n  iModel: IModelDb;\n}\n/** Argument for the `ElementAspect.onXxx` static methods that supply the properties of an aspect to be inserted or updated.\n * @beta\n */\nexport interface OnAspectPropsArg extends OnAspectArg {\n  /** The new properties of the aspect affected by this event. */\n  props: Readonly<ElementAspectProps>;\n}\n/** Argument for the `ElementAspect.onXxx` static methods that only supply the Id of the affected aspect.\n * @beta\n */\nexport interface OnAspectIdArg extends OnAspectArg {\n  /** The Id of the aspect affected by this event */\n  aspectId: Id64String;\n}\n\n/** An Element Aspect is a class that defines a set of properties that are related to (and owned by) a single element.\n * Semantically, an ElementAspect can be considered part of the Element. Thus, an ElementAspect is deleted if its owning Element is deleted.\n * BIS Guideline: Subclass ElementUniqueAspect or ElementMultiAspect rather than subclassing ElementAspect directly.\n * @public\n */\nexport class ElementAspect extends Entity {\n  /** @internal */\n  public static override get className(): string { return \"ElementAspect\"; }\n  public element: RelatedElement;\n\n  /** @internal */\n  constructor(props: ElementAspectProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.element = RelatedElement.fromJSON(props.element)!; // eslint-disable-line @typescript-eslint/no-non-null-assertion\n  }\n\n  /** @internal */\n  public override toJSON(): ElementAspectProps {\n    const val = super.toJSON() as ElementAspectProps;\n    val.element = this.element;\n    return val;\n  }\n\n  /** Called before a new ElementAspect is inserted.\n   * @note throw an exception to disallow the insert\n   * @note If you override this method, you must call super.\n   * @beta\n   */\n  protected static onInsert(_arg: OnAspectPropsArg): void { }\n\n  /** Called after a new ElementAspect was inserted.\n   * @note If you override this method, you must call super.\n   * @beta\n   */\n  protected static onInserted(_arg: OnAspectPropsArg): void { }\n\n  /** Called before an ElementAspect is updated.\n   * @note throw an exception to disallow the update\n   * @note If you override this method, you must call super.\n   * @beta\n   */\n  protected static onUpdate(_arg: OnAspectPropsArg): void { }\n\n  /** Called after an ElementAspect was updated.\n   * @note If you override this method, you must call super.\n   * @beta\n   */\n  protected static onUpdated(_arg: OnAspectPropsArg): void { }\n\n  /** Called before an ElementAspect is deleted.\n   * @note throw an exception to disallow the delete\n   * @note If you override this method, you must call super.\n   * @beta\n   */\n  protected static onDelete(_arg: OnAspectIdArg): void { }\n\n  /** Called after an ElementAspect was deleted.\n   * @note If you override this method, you must call super.\n   * @beta\n   */\n  protected static onDeleted(_arg: OnAspectIdArg): void { }\n}\n\n/** An Element Unique Aspect is an ElementAspect where there can be only zero or one instance of the Element Aspect class per Element.\n * @public\n */\nexport class ElementUniqueAspect extends ElementAspect {\n  /** @internal */\n  public static override get className(): string { return \"ElementUniqueAspect\"; }\n}\n\n/** An Element Multi-Aspect is an ElementAspect where there can be **n** instances of the Element Aspect class per Element.\n * @public\n */\nexport class ElementMultiAspect extends ElementAspect {\n  /** @internal */\n  public static override get className(): string { return \"ElementMultiAspect\"; }\n}\n\n/** A ChannelRootAspect identifies an Element as the root of a *channel* which is a subset of the overall iModel hierarchy that is independently maintained.\n * @note The associated ECClass was added to the BisCore schema in version 1.0.10\n * @public\n */\nexport class ChannelRootAspect extends ElementUniqueAspect {\n  /** @internal */\n  public static override get className(): string { return \"ChannelRootAspect\"; }\n\n  /** The owner of the channel */\n  public owner: string;\n\n  /** @internal */\n  constructor(props: ChannelRootAspectProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.owner = props.owner;\n  }\n\n  /** @internal */\n  public override toJSON(): ChannelRootAspectProps {\n    const val = super.toJSON() as ChannelRootAspectProps;\n    val.owner = this.owner;\n    return val;\n  }\n\n  /** Insert a ChannelRootAspect on the specified element. */\n  public static insert(iModel: IModelDb, ownerId: Id64String, ownerDescription: string) {\n    const props: ChannelRootAspectProps = {\n      classFullName: ChannelRootAspect.classFullName,\n      element: { id: ownerId },\n      owner: ownerDescription,\n    };\n    iModel.elements.insertAspect(props);\n  }\n}\n\n/** An ElementMultiAspect that stores synchronization information for an Element originating from an external source.\n * @note The associated ECClass was added to the BisCore schema in version 1.0.2\n * @public\n */\nexport class ExternalSourceAspect extends ElementMultiAspect {\n  /** @internal */\n  public static override get className(): string { return \"ExternalSourceAspect\"; }\n\n  /** An element that scopes the combination of `kind` and `identifier` to uniquely identify the object from the external source. */\n  public scope: RelatedElement;\n  /** The identifier of the object in the source repository. */\n  public identifier: string;\n  /** The kind of object within the source repository. */\n  public kind: string;\n  /** The cryptographic hash (any algorithm) of the source object's content. If defined, it must be guaranteed to change when the source object's content changes. */\n  public checksum?: string;\n  /** An optional value that is typically a version number or a pseudo version number like last modified time.\n   * It will be used by the synchronization process to detect that a source object is unchanged so that computing a cryptographic hash can be avoided.\n   * If present, this value must be guaranteed to change when any of the source object's content changes.\n   */\n  public version?: string;\n  /** A place where additional JSON properties can be stored. For example, provenance information or properties relating to the synchronization process. */\n  public jsonProperties?: string;\n  /** The source of the imported/synchronized object. Should point to an instance of [ExternalSource]($backend). */\n  public source?: RelatedElement;\n\n  /** @internal */\n  constructor(props: ExternalSourceAspectProps, iModel: IModelDb) {\n    super(props, iModel);\n    this.scope = RelatedElement.fromJSON(props.scope)!; // eslint-disable-line @typescript-eslint/no-non-null-assertion\n    this.source = RelatedElement.fromJSON(props.source);\n    this.identifier = props.identifier;\n    this.kind = props.kind;\n    this.checksum = props.checksum;\n    this.version = props.version;\n    this.jsonProperties = props.jsonProperties;\n  }\n\n  /**  Look up the ElementId of the element that contains an aspect with the specified Scope, Kind, and Identifier\n   */\n  public static findBySource(iModelDb: IModelDb, scope: Id64String, kind: string, identifier: string): { elementId?: Id64String, aspectId?: Id64String } {\n    const sql = `SELECT Element.Id, ECInstanceId FROM ${ExternalSourceAspect.classFullName} WHERE (Scope.Id=:scope AND Kind=:kind AND Identifier=:identifier)`;\n    let elementId: Id64String | undefined;\n    let aspectId: Id64String | undefined;\n    iModelDb.withPreparedStatement(sql, (statement: ECSqlStatement) => {\n      statement.bindId(\"scope\", scope);\n      statement.bindString(\"kind\", kind);\n      statement.bindString(\"identifier\", identifier);\n      if (DbResult.BE_SQLITE_ROW === statement.step()) {\n        elementId = statement.getValue(0).getId();\n        aspectId = statement.getValue(1).getId();\n      }\n    });\n    return { elementId, aspectId };\n  }\n\n  /** @internal */\n  public override toJSON(): ExternalSourceAspectProps {\n    const val = super.toJSON() as ExternalSourceAspectProps;\n    val.scope = this.scope;\n    val.source = this.source;\n    val.identifier = this.identifier;\n    val.kind = this.kind;\n    val.checksum = this.checksum;\n    val.version = this.version;\n    val.jsonProperties = this.jsonProperties;\n    return val;\n  }\n\n  /** @internal */\n  protected override collectReferenceConcreteIds(referenceIds: EntityReferenceSet): void {\n    super.collectReferenceConcreteIds(referenceIds);\n    referenceIds.addElement(this.scope.id);\n    referenceIds.addElement(this.element.id);\n    if (this.source)\n      referenceIds.addElement(this.source.id);\n  }\n}\n\n/** @public */\nexport namespace ExternalSourceAspect { // eslint-disable-line no-redeclare\n  /** Standard values for the `Kind` property of `ExternalSourceAspect`.\n   * @public\n   */\n  export enum Kind {\n    /** Indicates that the [[ExternalSourceAspect]] is storing [[Element]] provenance */\n    Element = \"Element\",\n    /** Indicates that the [[ExternalSourceAspect]] is storing [[Relationship]] provenance */\n    Relationship = \"Relationship\",\n    /** Indicates that the [[ExternalSourceAspect]] is storing *scope* provenance\n     * @see [[ExternalSourceAspect.scope]]\n     */\n    Scope = \"Scope\",\n  }\n}\n"]}

package/lib/cjs/ElementGraphics.d.ts

@@ -1,10 +1,10 @@
-/** @packageDocumentation
- * @module Tiles
- */
-import { ElementGraphicsRequestProps } from "@itwin/core-common";
-import { IModelDb } from "./IModelDb";
-/** See [[IModelDb.generateElementGraphics]] and IModelTileRpcImpl.requestElementGraphics.
- * @internal
- */
-export declare function generateElementGraphics(request: ElementGraphicsRequestProps, iModel: IModelDb): Promise<Uint8Array | undefined>;
+/** @packageDocumentation
+ * @module Tiles
+ */
+import { ElementGraphicsRequestProps } from "@itwin/core-common";
+import { IModelDb } from "./IModelDb";
+/** See [[IModelDb.generateElementGraphics]] and IModelTileRpcImpl.requestElementGraphics.
+ * @internal
+ */
+export declare function generateElementGraphics(request: ElementGraphicsRequestProps, iModel: IModelDb): Promise<Uint8Array | undefined>;
 //# sourceMappingURL=ElementGraphics.d.ts.map

package/lib/cjs/ElementGraphics.js

@@ -1,42 +1,42 @@
-"use strict";
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Tiles
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateElementGraphics = void 0;
-const core_bentley_1 = require("@itwin/core-bentley");
-const core_common_1 = require("@itwin/core-common");
-/** See [[IModelDb.generateElementGraphics]] and IModelTileRpcImpl.requestElementGraphics.
- * @internal
- */
-async function generateElementGraphics(request, iModel) {
-    const result = await iModel.nativeDb.generateElementGraphics(request); // ###TODO update package versions in addon
-    let error;
-    switch (result.status) {
-        case 2 /* NoGeometry */:
-        case 1 /* Canceled */:
-            return undefined;
-        case 0 /* Success */:
-            return result.content;
-        case 3 /* InvalidJson */:
-            error = "Invalid JSON";
-            break;
-        case 4 /* UnknownMajorFormatVersion */:
-            error = "Unknown major format version";
-            break;
-        case 5 /* ElementNotFound */:
-            error = `Element Id ${request.elementId} not found`;
-            break;
-        case 6 /* DuplicateRequestId */:
-            error = `Duplicate request Id "${request.id}"`;
-            break;
-    }
-    (0, core_bentley_1.assert)(undefined !== error);
-    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, error);
-}
-exports.generateElementGraphics = generateElementGraphics;
+"use strict";
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Tiles
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateElementGraphics = void 0;
+const core_bentley_1 = require("@itwin/core-bentley");
+const core_common_1 = require("@itwin/core-common");
+/** See [[IModelDb.generateElementGraphics]] and IModelTileRpcImpl.requestElementGraphics.
+ * @internal
+ */
+async function generateElementGraphics(request, iModel) {
+    const result = await iModel.nativeDb.generateElementGraphics(request); // ###TODO update package versions in addon
+    let error;
+    switch (result.status) {
+        case 2 /* NoGeometry */:
+        case 1 /* Canceled */:
+            return undefined;
+        case 0 /* Success */:
+            return result.content;
+        case 3 /* InvalidJson */:
+            error = "Invalid JSON";
+            break;
+        case 4 /* UnknownMajorFormatVersion */:
+            error = "Unknown major format version";
+            break;
+        case 5 /* ElementNotFound */:
+            error = `Element Id ${request.elementId} not found`;
+            break;
+        case 6 /* DuplicateRequestId */:
+            error = `Duplicate request Id "${request.id}"`;
+            break;
+    }
+    (0, core_bentley_1.assert)(undefined !== error);
+    throw new core_common_1.IModelError(core_bentley_1.IModelStatus.BadRequest, error);
+}
+exports.generateElementGraphics = generateElementGraphics;
 //# sourceMappingURL=ElementGraphics.js.map

package/lib/cjs/ElementGraphics.js.map

@@ -1 +1 @@
-{"version":3,"file":"ElementGraphics.js","sourceRoot":"","sources":["../../src/ElementGraphics.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAA2D;AAC3D,oDAA8E;AAI9E;;GAEG;AACI,KAAK,UAAU,uBAAuB,CAAC,OAAoC,EAAE,MAAgB;IAClG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAC,OAAc,CAAC,CAAC,CAAC,2CAA2C;IAEzH,IAAI,KAAyB,CAAC;IAC9B,QAAQ,MAAM,CAAC,MAAM,EAAE;QACrB,wBAAsC;QACtC;YACE,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB;YACE,KAAK,GAAG,cAAc,CAAC;YACvB,MAAM;QACR;YACE,KAAK,GAAG,8BAA8B,CAAC;YACvC,MAAM;QACR;YACE,KAAK,GAAG,cAAc,OAAO,CAAC,SAAS,YAAY,CAAC;YACpD,MAAM;QACR;YACE,KAAK,GAAG,yBAAyB,OAAO,CAAC,EAAE,GAAG,CAAC;YAC/C,MAAM;KACT;IAED,IAAA,qBAAM,EAAC,SAAS,KAAK,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AA1BD,0DA0BC","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 Tiles\r\n */\r\n\r\nimport { assert, IModelStatus } from \"@itwin/core-bentley\";\r\nimport { ElementGraphicsRequestProps, IModelError } from \"@itwin/core-common\";\r\nimport { ElementGraphicsStatus } from \"@bentley/imodeljs-native\";\r\nimport { IModelDb } from \"./IModelDb\";\r\n\r\n/** See [[IModelDb.generateElementGraphics]] and IModelTileRpcImpl.requestElementGraphics.\r\n * @internal\r\n */\r\nexport async function generateElementGraphics(request: ElementGraphicsRequestProps, iModel: IModelDb): Promise<Uint8Array | undefined> {\r\n  const result = await iModel.nativeDb.generateElementGraphics(request as any); // ###TODO update package versions in addon\r\n\r\n  let error: string | undefined;\r\n  switch (result.status) {\r\n    case ElementGraphicsStatus.NoGeometry:\r\n    case ElementGraphicsStatus.Canceled:\r\n      return undefined;\r\n    case ElementGraphicsStatus.Success:\r\n      return result.content;\r\n    case ElementGraphicsStatus.InvalidJson:\r\n      error = \"Invalid JSON\";\r\n      break;\r\n    case ElementGraphicsStatus.UnknownMajorFormatVersion:\r\n      error = \"Unknown major format version\";\r\n      break;\r\n    case ElementGraphicsStatus.ElementNotFound:\r\n      error = `Element Id ${request.elementId} not found`;\r\n      break;\r\n    case ElementGraphicsStatus.DuplicateRequestId:\r\n      error = `Duplicate request Id \"${request.id}\"`;\r\n      break;\r\n  }\r\n\r\n  assert(undefined !== error);\r\n  throw new IModelError(IModelStatus.BadRequest, error);\r\n}\r\n"]}
+{"version":3,"file":"ElementGraphics.js","sourceRoot":"","sources":["../../src/ElementGraphics.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,sDAA2D;AAC3D,oDAA8E;AAI9E;;GAEG;AACI,KAAK,UAAU,uBAAuB,CAAC,OAAoC,EAAE,MAAgB;IAClG,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,uBAAuB,CAAC,OAAc,CAAC,CAAC,CAAC,2CAA2C;IAEzH,IAAI,KAAyB,CAAC;IAC9B,QAAQ,MAAM,CAAC,MAAM,EAAE;QACrB,wBAAsC;QACtC;YACE,OAAO,SAAS,CAAC;QACnB;YACE,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB;YACE,KAAK,GAAG,cAAc,CAAC;YACvB,MAAM;QACR;YACE,KAAK,GAAG,8BAA8B,CAAC;YACvC,MAAM;QACR;YACE,KAAK,GAAG,cAAc,OAAO,CAAC,SAAS,YAAY,CAAC;YACpD,MAAM;QACR;YACE,KAAK,GAAG,yBAAyB,OAAO,CAAC,EAAE,GAAG,CAAC;YAC/C,MAAM;KACT;IAED,IAAA,qBAAM,EAAC,SAAS,KAAK,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,yBAAW,CAAC,2BAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AA1BD,0DA0BC","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module Tiles\n */\n\nimport { assert, IModelStatus } from \"@itwin/core-bentley\";\nimport { ElementGraphicsRequestProps, IModelError } from \"@itwin/core-common\";\nimport { ElementGraphicsStatus } from \"@bentley/imodeljs-native\";\nimport { IModelDb } from \"./IModelDb\";\n\n/** See [[IModelDb.generateElementGraphics]] and IModelTileRpcImpl.requestElementGraphics.\n * @internal\n */\nexport async function generateElementGraphics(request: ElementGraphicsRequestProps, iModel: IModelDb): Promise<Uint8Array | undefined> {\n  const result = await iModel.nativeDb.generateElementGraphics(request as any); // ###TODO update package versions in addon\n\n  let error: string | undefined;\n  switch (result.status) {\n    case ElementGraphicsStatus.NoGeometry:\n    case ElementGraphicsStatus.Canceled:\n      return undefined;\n    case ElementGraphicsStatus.Success:\n      return result.content;\n    case ElementGraphicsStatus.InvalidJson:\n      error = \"Invalid JSON\";\n      break;\n    case ElementGraphicsStatus.UnknownMajorFormatVersion:\n      error = \"Unknown major format version\";\n      break;\n    case ElementGraphicsStatus.ElementNotFound:\n      error = `Element Id ${request.elementId} not found`;\n      break;\n    case ElementGraphicsStatus.DuplicateRequestId:\n      error = `Duplicate request Id \"${request.id}\"`;\n      break;\n  }\n\n  assert(undefined !== error);\n  throw new IModelError(IModelStatus.BadRequest, error);\n}\n"]}