@itwin/ecschema-editing 4.7.0-dev.8 → 4.8.0-dev.0

package/lib/cjs/Editing/PropertyCategories.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyCategories.d.ts","sourceRoot":"","sources":["../../../src/Editing/PropertyCategories.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAmC,qBAAqB,EAAE,aAAa,EAAkB,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC5I,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAGtE;;;GAGG;AACH,qBAAa,kBAAkB;IACV,SAAS,CAAC,aAAa,EAAE,mBAAmB;gBAAlC,aAAa,EAAE,mBAAmB;IAClD,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAanH,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,qBAAqB,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgBnH,WAAW,CAAC,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAW1F"}
+{"version":3,"file":"PropertyCategories.d.ts","sourceRoot":"","sources":["../../../src/Editing/PropertyCategories.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAoB,qBAAqB,EAAE,aAAa,EAAkB,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC7H,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAG/C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;gBAC9B,YAAY,EAAE,mBAAmB;IAIvC,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAa3G,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,qBAAqB,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC;IAS3G,WAAW,CAAC,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ1F"}

package/lib/cjs/Editing/PropertyCategories.js

@@ -9,43 +9,45 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PropertyCategories = void 0;
 const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
+const Exception_1 = require("./Exception");
+const SchemaItems_1 = require("./SchemaItems");
 /**
  * @alpha
  * A class allowing you to create schema items of type Property Category.
  */
-class PropertyCategories {
-    constructor(_schemaEditor) {
-        this._schemaEditor = _schemaEditor;
+class PropertyCategories extends SchemaItems_1.SchemaItems {
+    constructor(schemaEditor) {
+        super(ecschema_metadata_1.SchemaItemType.PropertyCategory, schemaEditor);
     }
     async create(schemaKey, name, priority, displayLabel) {
-        const schema = await this._schemaEditor.getSchema(schemaKey);
-        if (schema === undefined)
-            return { errorMessage: `Schema Key ${schemaKey.toString(true)} not found in context` };
-        const newPropCategory = (await schema.createPropertyCategory(name));
-        newPropCategory.setPriority(priority);
-        if (displayLabel)
-            newPropCategory.setDisplayLabel(displayLabel);
-        return { itemKey: newPropCategory.key };
+        try {
+            const newPropCategory = await this.createSchemaItem(schemaKey, this.schemaItemType, (schema) => schema.createPropertyCategory.bind(schema), name);
+            newPropCategory.setPriority(priority);
+            if (displayLabel)
+                newPropCategory.setDisplayLabel(displayLabel);
+            return newPropCategory.key;
+        }
+        catch (e) {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.CreateSchemaItemFailed, new Exception_1.SchemaItemId(this.schemaItemType, name, schemaKey), e);
+        }
     }
     async createFromProps(schemaKey, propertyCategoryProps) {
-        const schema = await this._schemaEditor.getSchema(schemaKey);
-        if (schema === undefined)
-            return { errorMessage: `Schema Key ${schemaKey.toString(true)} not found in context` };
-        if (propertyCategoryProps.name === undefined)
-            return { errorMessage: `No name was supplied within props.` };
-        const newPropCategory = (await schema.createPropertyCategory(propertyCategoryProps.name));
-        if (newPropCategory === undefined)
-            return { errorMessage: `Failed to create class ${propertyCategoryProps.name} in schema ${schemaKey.toString(true)}.` };
-        await newPropCategory.fromJSON(propertyCategoryProps);
-        return { itemKey: newPropCategory.key };
+        try {
+            const newPropCategory = await this.createSchemaItemFromProps(schemaKey, this.schemaItemType, (schema) => schema.createPropertyCategory.bind(schema), propertyCategoryProps);
+            return newPropCategory.key;
+        }
+        catch (e) {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.CreateSchemaItemFromProps, new Exception_1.SchemaItemId(this.schemaItemType, propertyCategoryProps.name, schemaKey), e);
+        }
     }
     async setPriority(propCategoryKey, priority) {
-        const propertyCategory = (await this._schemaEditor.schemaContext.getSchemaItem(propCategoryKey));
-        if (propertyCategory === undefined)
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.ClassNotFound, `Property Category ${propCategoryKey.fullName} not found in schema context.`);
-        if (propertyCategory.schemaItemType !== ecschema_metadata_1.SchemaItemType.PropertyCategory)
-            throw new ecschema_metadata_1.ECObjectsError(ecschema_metadata_1.ECObjectsStatus.InvalidSchemaItemType, `Expected ${propCategoryKey.fullName} to be of type Property Category.`);
-        propertyCategory.setPriority(priority);
+        try {
+            const propertyCategory = await this.getSchemaItem(propCategoryKey);
+            propertyCategory.setPriority(priority);
+        }
+        catch (e) {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.SetPropertyCategoryPriority, new Exception_1.SchemaItemId(this.schemaItemType, propCategoryKey), e);
+        }
     }
 }
 exports.PropertyCategories = PropertyCategories;

package/lib/cjs/Editing/PropertyCategories.js.map

@@ -1 +1 @@
-{"version":3,"file":"PropertyCategories.js","sourceRoot":"","sources":["../../../src/Editing/PropertyCategories.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,gEAA4I;AAI5I;;;GAGG;AACH,MAAa,kBAAkB;IAC7B,YAA6B,aAAkC;QAAlC,kBAAa,GAAb,aAAa,CAAqB;IAAI,CAAC;IAC7D,KAAK,CAAC,MAAM,CAAC,SAAoB,EAAE,IAAY,EAAE,QAAgB,EAAE,YAAqB;QAC7F,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,MAAM,KAAK,SAAS;YACtB,OAAO,EAAE,YAAY,EAAE,cAAc,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAEzF,MAAM,eAAe,GAAG,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAA4B,CAAC;QAC/F,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACtC,IAAI,YAAY;YACd,eAAe,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;QAEhD,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,EAAE,CAAC;IAC1C,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,SAAoB,EAAE,qBAA4C;QAC7F,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,MAAM,KAAK,SAAS;YACtB,OAAO,EAAE,YAAY,EAAE,cAAc,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC;QAEzF,IAAI,qBAAqB,CAAC,IAAI,KAAK,SAAS;YAC1C,OAAO,EAAE,YAAY,EAAE,oCAAoC,EAAE,CAAC;QAEhE,MAAM,eAAe,GAAG,CAAC,MAAM,MAAM,CAAC,sBAAsB,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAA4B,CAAC;QACrH,IAAI,eAAe,KAAK,SAAS;YAC/B,OAAO,EAAE,YAAY,EAAE,0BAA0B,qBAAqB,CAAC,IAAI,cAAc,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QAEzH,MAAM,eAAe,CAAC,QAAQ,CAAC,qBAAqB,CAAC,CAAC;QACtD,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,GAAG,EAAE,CAAC;IAC1C,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,eAA8B,EAAE,QAAgB;QACvE,MAAM,gBAAgB,GAAG,CAAC,MAAM,IAAI,CAAC,aAAa,CAAC,aAAa,CAAC,aAAa,CAA0B,eAAe,CAAC,CAAC,CAAC;QAE1H,IAAI,gBAAgB,KAAK,SAAS;YAChC,MAAM,IAAI,kCAAc,CAAC,mCAAe,CAAC,aAAa,EAAE,qBAAqB,eAAe,CAAC,QAAQ,+BAA+B,CAAC,CAAC;QAExI,IAAI,gBAAgB,CAAC,cAAc,KAAK,kCAAc,CAAC,gBAAgB;YACrE,MAAM,IAAI,kCAAc,CAAC,mCAAe,CAAC,qBAAqB,EAAE,YAAY,eAAe,CAAC,QAAQ,mCAAmC,CAAC,CAAC;QAE3I,gBAAgB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IACzC,CAAC;CACF;AA1CD,gDA0CC","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 Editing\n */\n\nimport { ECObjectsError, ECObjectsStatus, PropertyCategoryProps, SchemaItemKey, SchemaItemType, SchemaKey } from \"@itwin/ecschema-metadata\";\nimport { SchemaContextEditor, SchemaItemEditResults } from \"./Editor\";\nimport { MutablePropertyCategory } from \"./Mutable/MutablePropertyCategory\";\n\n/**\n * @alpha\n * A class allowing you to create schema items of type Property Category.\n */\nexport class PropertyCategories {\n  public constructor(protected _schemaEditor: SchemaContextEditor) { }\n  public async create(schemaKey: SchemaKey, name: string, priority: number, displayLabel?: string): Promise<SchemaItemEditResults> {\n    const schema = await this._schemaEditor.getSchema(schemaKey);\n    if (schema === undefined)\n      return { errorMessage: `Schema Key ${schemaKey.toString(true)} not found in context` };\n\n    const newPropCategory = (await schema.createPropertyCategory(name)) as MutablePropertyCategory;\n    newPropCategory.setPriority(priority);\n    if (displayLabel)\n      newPropCategory.setDisplayLabel(displayLabel);\n\n    return { itemKey: newPropCategory.key };\n  }\n\n  public async createFromProps(schemaKey: SchemaKey, propertyCategoryProps: PropertyCategoryProps): Promise<SchemaItemEditResults> {\n    const schema = await this._schemaEditor.getSchema(schemaKey);\n    if (schema === undefined)\n      return { errorMessage: `Schema Key ${schemaKey.toString(true)} not found in context` };\n\n    if (propertyCategoryProps.name === undefined)\n      return { errorMessage: `No name was supplied within props.` };\n\n    const newPropCategory = (await schema.createPropertyCategory(propertyCategoryProps.name)) as MutablePropertyCategory;\n    if (newPropCategory === undefined)\n      return { errorMessage: `Failed to create class ${propertyCategoryProps.name} in schema ${schemaKey.toString(true)}.` };\n\n    await newPropCategory.fromJSON(propertyCategoryProps);\n    return { itemKey: newPropCategory.key };\n  }\n\n  public async setPriority(propCategoryKey: SchemaItemKey, priority: number): Promise<void> {\n    const propertyCategory = (await this._schemaEditor.schemaContext.getSchemaItem<MutablePropertyCategory>(propCategoryKey));\n\n    if (propertyCategory === undefined)\n      throw new ECObjectsError(ECObjectsStatus.ClassNotFound, `Property Category ${propCategoryKey.fullName} not found in schema context.`);\n\n    if (propertyCategory.schemaItemType !== SchemaItemType.PropertyCategory)\n      throw new ECObjectsError(ECObjectsStatus.InvalidSchemaItemType, `Expected ${propCategoryKey.fullName} to be of type Property Category.`);\n\n    propertyCategory.setPriority(priority);\n  }\n}\n"]}
+{"version":3,"file":"PropertyCategories.js","sourceRoot":"","sources":["../../../src/Editing/PropertyCategories.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,gEAA6H;AAG7H,2CAAgF;AAChF,+CAA4C;AAE5C;;;GAGG;AACH,MAAa,kBAAmB,SAAQ,yBAAW;IACjD,YAAmB,YAAiC;QAClD,KAAK,CAAC,kCAAc,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,SAAoB,EAAE,IAAY,EAAE,QAAgB,EAAE,YAAqB;QAC7F,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAmB,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAA4B,CAAC;YAC/L,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,YAAY;gBACd,eAAe,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;YAEhD,OAAO,eAAe,CAAC,GAAG,CAAC;QAC7B,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,MAAM,IAAI,8BAAkB,CAAC,2BAAe,CAAC,sBAAsB,EAAE,IAAI,wBAAY,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAClI,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,eAAe,CAAC,SAAoB,EAAE,qBAA4C;QAC7F,IAAI,CAAC;YACH,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC,CAAC;YAC5K,OAAO,eAAe,CAAC,GAAG,CAAC;QAC7B,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,MAAM,IAAI,8BAAkB,CAAC,2BAAe,CAAC,yBAAyB,EAAE,IAAI,wBAAY,CAAC,IAAI,CAAC,cAAc,EAAE,qBAAqB,CAAC,IAAK,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5J,CAAC;IACH,CAAC;IAEM,KAAK,CAAC,WAAW,CAAC,eAA8B,EAAE,QAAgB;QACvE,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,aAAa,CAA0B,eAAe,CAAC,CAAC;YAC5F,gBAAgB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;QACzC,CAAC;QAAC,OAAM,CAAM,EAAE,CAAC;YACf,MAAM,IAAI,8BAAkB,CAAC,2BAAe,CAAC,2BAA2B,EAAE,IAAI,wBAAY,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;QACvI,CAAC;IACH,CAAC;CACF;AAnCD,gDAmCC","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 Editing\r\n */\r\n\r\nimport { PropertyCategory, PropertyCategoryProps, SchemaItemKey, SchemaItemType, SchemaKey } from \"@itwin/ecschema-metadata\";\r\nimport { SchemaContextEditor } from \"./Editor\";\r\nimport { MutablePropertyCategory } from \"./Mutable/MutablePropertyCategory\";\r\nimport { ECEditingStatus, SchemaEditingError, SchemaItemId } from \"./Exception\";\r\nimport { SchemaItems } from \"./SchemaItems\";\r\n\r\n/**\r\n * @alpha\r\n * A class allowing you to create schema items of type Property Category.\r\n */\r\nexport class PropertyCategories extends SchemaItems {\r\n  public constructor(schemaEditor: SchemaContextEditor) {\r\n    super(SchemaItemType.PropertyCategory, schemaEditor);\r\n  }\r\n\r\n  public async create(schemaKey: SchemaKey, name: string, priority: number, displayLabel?: string): Promise<SchemaItemKey> {\r\n    try {\r\n      const newPropCategory = await this.createSchemaItem<PropertyCategory>(schemaKey, this.schemaItemType, (schema) => schema.createPropertyCategory.bind(schema), name) as MutablePropertyCategory;\r\n      newPropCategory.setPriority(priority);\r\n      if (displayLabel)\r\n        newPropCategory.setDisplayLabel(displayLabel);\r\n\r\n      return newPropCategory.key;\r\n    } catch (e: any) {\r\n      throw new SchemaEditingError(ECEditingStatus.CreateSchemaItemFailed, new SchemaItemId(this.schemaItemType, name, schemaKey), e);\r\n    }\r\n  }\r\n\r\n  public async createFromProps(schemaKey: SchemaKey, propertyCategoryProps: PropertyCategoryProps): Promise<SchemaItemKey> {\r\n    try {\r\n      const newPropCategory = await this.createSchemaItemFromProps(schemaKey, this.schemaItemType, (schema) => schema.createPropertyCategory.bind(schema), propertyCategoryProps);\r\n      return newPropCategory.key;\r\n    } catch (e: any) {\r\n      throw new SchemaEditingError(ECEditingStatus.CreateSchemaItemFromProps, new SchemaItemId(this.schemaItemType, propertyCategoryProps.name!, schemaKey), e);\r\n    }\r\n  }\r\n\r\n  public async setPriority(propCategoryKey: SchemaItemKey, priority: number): Promise<void> {\r\n    try {\r\n      const propertyCategory = await this.getSchemaItem<MutablePropertyCategory>(propCategoryKey);\r\n      propertyCategory.setPriority(priority);\r\n    } catch(e: any) {\r\n      throw new SchemaEditingError(ECEditingStatus.SetPropertyCategoryPriority, new SchemaItemId(this.schemaItemType, propCategoryKey), e);\r\n    }\r\n  }\r\n}\r\n"]}

package/lib/cjs/Editing/RelationshipClasses.d.ts

@@ -2,7 +2,7 @@
  * @module Editing
  */
 import { CustomAttribute, ECClassModifier, EntityClass, Mixin, NavigationPropertyProps, RelationshipClass, RelationshipClassProps, RelationshipConstraint, RelationshipEnd, RelationshipMultiplicity, SchemaItemKey, SchemaKey, StrengthDirection, StrengthType } from "@itwin/ecschema-metadata";
-import { PropertyEditResults, SchemaContextEditor, SchemaItemEditResults } from "./Editor";
+import { SchemaContextEditor } from "./Editor";
 import { ECClasses } from "./ECClasses";
 import { NavigationProperties } from "./Properties";
 /**
@@ -24,47 +24,45 @@ export declare class RelationshipClasses extends ECClasses {
      * @param StrengthDirection The relationship StrengthDirection of the class.
      * @param baseClassKey An optional SchemaItemKey that specifies the base relationship class.
      */
-    create(schemaKey: SchemaKey, name: string, modifier: ECClassModifier, strength: StrengthType, direction: StrengthDirection, baseClassKey?: SchemaItemKey): Promise<SchemaItemEditResults>;
+    create(schemaKey: SchemaKey, name: string, modifier: ECClassModifier, strength: StrengthType, direction: StrengthDirection, baseClassKey?: SchemaItemKey): Promise<SchemaItemKey>;
     /**
      * Sets the source RelationshipConstraint on the relationship.
      * @param relationshipKey The SchemaItemKey for the relationship.
      * @param source The RelationshipConstraint to add.
-     * @returns A promise of type SchemaItemEditResults.
      */
-    setSourceConstraint(relationshipKey: SchemaItemKey, source: RelationshipConstraint): Promise<SchemaItemEditResults>;
+    setSourceConstraint(relationshipKey: SchemaItemKey, source: RelationshipConstraint): Promise<void>;
     /**
      * Sets the target RelationshipConstraint on the relationship.
      * @param relationshipKey The SchemaItemKey for the relationship.
      * @param target The RelationshipConstraint to add.
-     * @returns A promise of type SchemaItemEditResults.
      */
-    setTargetConstraint(relationshipKey: SchemaItemKey, target: RelationshipConstraint): Promise<SchemaItemEditResults>;
+    setTargetConstraint(relationshipKey: SchemaItemKey, target: RelationshipConstraint): Promise<void>;
     /**
      * Creates a RelationshipClass through a RelationshipClassProps.
      * @param schemaKey a SchemaKey of the Schema that will house the new object.
      * @param relationshipProps a json object that will be used to populate the new RelationshipClass. Needs a name value passed in.
      */
-    createFromProps(schemaKey: SchemaKey, relationshipProps: RelationshipClassProps): Promise<SchemaItemEditResults>;
+    createFromProps(schemaKey: SchemaKey, relationshipProps: RelationshipClassProps): Promise<SchemaItemKey>;
     /**
      * Sets the base class of a RelationshipClass.
      * @param relationshipKey The SchemaItemKey of the RelationshipClass.
      * @param baseClassKey The SchemaItemKey of the base class. Specifying 'undefined' removes the base class.
      */
-    setBaseClass(itemKey: SchemaItemKey, baseClassKey?: SchemaItemKey): Promise<SchemaItemEditResults>;
-    createNavigationProperty(relationshipKey: SchemaItemKey, name: string, relationship: string | RelationshipClass, direction: string | StrengthDirection): Promise<PropertyEditResults>;
+    setBaseClass(itemKey: SchemaItemKey, baseClassKey?: SchemaItemKey): Promise<void>;
+    createNavigationProperty(relationshipKey: SchemaItemKey, name: string, relationship: string | RelationshipClass, direction: string | StrengthDirection): Promise<void>;
     /**
      * Creates a Navigation Property through a NavigationPropertyProps.
      * @param classKey a SchemaItemKey of the Relationship Class that will house the new property.
      * @param navigationProps a json object that will be used to populate the new Navigation Property.
      */
-    createNavigationPropertyFromProps(relationshipKey: SchemaItemKey, navigationProps: NavigationPropertyProps): Promise<PropertyEditResults>;
-    setConstraintMultiplicity(constraint: RelationshipConstraint, multiplicity: RelationshipMultiplicity): Promise<SchemaItemEditResults>;
-    setConstraintPolymorphic(constraint: RelationshipConstraint, polymorphic: boolean): Promise<SchemaItemEditResults>;
-    setConstraintRelationshipEnd(constraint: RelationshipConstraint, relationshipEnd: RelationshipEnd): Promise<SchemaItemEditResults>;
-    setAbstractConstraint(constraint: RelationshipConstraint, abstractConstraint?: EntityClass | Mixin | RelationshipClass): Promise<SchemaItemEditResults>;
-    addConstraintClass(constraint: RelationshipConstraint, ecClass: EntityClass | Mixin | RelationshipClass): Promise<SchemaItemEditResults>;
-    removeConstraintClass(constraint: RelationshipConstraint, ecClass: EntityClass | Mixin | RelationshipClass): Promise<SchemaItemEditResults>;
-    addCustomAttributeToConstraint(constraint: RelationshipConstraint, customAttribute: CustomAttribute): Promise<SchemaItemEditResults>;
+    createNavigationPropertyFromProps(relationshipKey: SchemaItemKey, navigationProps: NavigationPropertyProps): Promise<void>;
+    setConstraintMultiplicity(constraint: RelationshipConstraint, multiplicity: RelationshipMultiplicity): Promise<void>;
+    setConstraintPolymorphic(constraint: RelationshipConstraint, polymorphic: boolean): Promise<void>;
+    setConstraintRelationshipEnd(constraint: RelationshipConstraint, relationshipEnd: RelationshipEnd): Promise<void>;
+    setAbstractConstraint(constraint: RelationshipConstraint, abstractConstraint?: EntityClass | Mixin | RelationshipClass): Promise<void>;
+    addConstraintClass(constraint: RelationshipConstraint, ecClass: EntityClass | Mixin | RelationshipClass): Promise<void>;
+    removeConstraintClass(constraint: RelationshipConstraint, ecClass: EntityClass | Mixin | RelationshipClass): Promise<void>;
+    addCustomAttributeToConstraint(constraint: RelationshipConstraint, customAttribute: CustomAttribute): Promise<void>;
     private validate;
 }
 //# sourceMappingURL=RelationshipClasses.d.ts.map

package/lib/cjs/Editing/RelationshipClasses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RelationshipClasses.d.ts","sourceRoot":"","sources":["../../../src/Editing/RelationshipClasses.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EACL,eAAe,EAA2B,eAAe,EAAE,WAAW,EAAyC,KAAK,EAAE,uBAAuB,EAC7I,iBAAiB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,eAAe,EAAE,wBAAwB,EAAE,aAAa,EAC3H,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAC3C,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBAC7B,YAAY,EAAE,mBAAmB;IAIpD;;OAEG;IACH,SAAgB,oBAAoB,uBAAqE;IAEzG;;;;;;;;OAQG;IACU,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;IA6BtM;;;;;OAKG;IACU,mBAAmB,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUhI;;;;;OAKG;IACU,mBAAmB,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAUhI;;;;OAIG;IACU,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAgB7H;;;;OAIG;IACmB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAe3G,wBAAwB,CAAC,eAAe,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAalM;;;;OAIG;IACU,iCAAiC,CAAC,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAczI,yBAAyB,CAAC,UAAU,EAAE,sBAAsB,EAAE,YAAY,EAAE,wBAAwB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAMrI,wBAAwB,CAAC,UAAU,EAAE,sBAAsB,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAMlH,4BAA4B,CAAC,UAAU,EAAE,sBAAsB,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAMlI,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,EAAE,kBAAkB,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAyBvJ,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,GAAG,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAmBxI,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,GAAG,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAa3I,8BAA8B,CAAC,UAAU,EAAE,sBAAsB,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAkBnI,QAAQ;CAoBvB"}
+{"version":3,"file":"RelationshipClasses.d.ts","sourceRoot":"","sources":["../../../src/Editing/RelationshipClasses.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EACL,eAAe,EAA2B,eAAe,EAAE,WAAW,EAAyC,KAAK,EAAE,uBAAuB,EAC7I,iBAAiB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,eAAe,EAAE,wBAAwB,EAAE,aAAa,EAC3H,SAAS,EAAE,iBAAiB,EAAE,YAAY,EAC3C,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAIxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAGpD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;gBAC7B,YAAY,EAAE,mBAAmB;IAIpD;;OAEG;IACH,SAAgB,oBAAoB,uBAAoE;IAExG;;;;;;;;OAQG;IACU,MAAM,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,iBAAiB,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAa9L;;;;OAIG;IACU,mBAAmB,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/G;;;;OAIG;IACU,mBAAmB,CAAC,eAAe,EAAE,aAAa,EAAE,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAS/G;;;;OAIG;IACU,eAAe,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,sBAAsB,GAAG,OAAO,CAAC,aAAa,CAAC;IAarH;;;;OAIG;IACmB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,YAAY,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1F,wBAAwB,CAAC,eAAe,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IASnL;;;;OAIG;IACU,iCAAiC,CAAC,eAAe,EAAE,aAAa,EAAE,eAAe,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU1H,yBAAyB,CAAC,UAAU,EAAE,sBAAsB,EAAE,YAAY,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpH,wBAAwB,CAAC,UAAU,EAAE,sBAAsB,EAAE,WAAW,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjG,4BAA4B,CAAC,UAAU,EAAE,sBAAsB,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjH,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,EAAE,kBAAkB,CAAC,EAAE,WAAW,GAAG,KAAK,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBtI,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBvH,qBAAqB,CAAC,UAAU,EAAE,sBAAsB,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,GAAG,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY1H,8BAA8B,CAAC,UAAU,EAAE,sBAAsB,EAAE,eAAe,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;YAkBlH,QAAQ;CAyBvB"}

package/lib/cjs/Editing/RelationshipClasses.js

@@ -12,6 +12,7 @@ const ecschema_metadata_1 = require("@itwin/ecschema-metadata");
 const ECClasses_1 = require("./ECClasses");
 const Rules = require("../Validation/ECRules");
 const Properties_1 = require("./Properties");
+const Exception_1 = require("./Exception");
 /**
  * @alpha
  * A class extending ECClasses allowing you to create schema items of type RelationshipClass.
@@ -22,7 +23,7 @@ class RelationshipClasses extends ECClasses_1.ECClasses {
         /**
          * Allows access for editing of NavigationProperty attributes.
          */
-        this.navigationProperties = new Properties_1.NavigationProperties(this.schemaItemType, this._schemaEditor);
+        this.navigationProperties = new Properties_1.NavigationProperties(this.schemaItemType, this.schemaEditor);
     }
     /**
      * Creates a RelationshipClass.
@@ -34,52 +35,39 @@ class RelationshipClasses extends ECClasses_1.ECClasses {
      * @param baseClassKey An optional SchemaItemKey that specifies the base relationship class.
      */
     async create(schemaKey, name, modifier, strength, direction, baseClassKey) {
-        const schema = await this._schemaEditor.getSchema(schemaKey);
-        if (schema === undefined) {
-            return { errorMessage: `Schema Key ${schemaKey.toString(true)} not found in context` };
-        }
-        const newClass = (await schema.createRelationshipClass(name, modifier));
-        if (baseClassKey !== undefined) {
-            const baseClassSchema = !baseClassKey.schemaKey.matches(schema.schemaKey) ? await this._schemaEditor.getSchema(baseClassKey.schemaKey) : schema;
-            if (baseClassSchema === undefined) {
-                return { errorMessage: `Schema Key ${baseClassKey.schemaKey.toString(true)} not found in context` };
-            }
-            const baseClassItem = await baseClassSchema.lookupItem(baseClassKey);
-            if (baseClassItem === undefined)
-                return { errorMessage: `Unable to locate base class ${baseClassKey.fullName} in schema ${baseClassSchema.fullName}.` };
-            if (baseClassItem.schemaItemType !== ecschema_metadata_1.SchemaItemType.RelationshipClass)
-                return { errorMessage: `${baseClassItem.fullName} is not of type Relationship Class.` };
-            newClass.baseClass = new ecschema_metadata_1.DelayedPromiseWithProps(baseClassKey, async () => baseClassItem);
+        try {
+            const newClass = await this.createClass(schemaKey, this.schemaItemType, (schema) => schema.createRelationshipClass.bind(schema), name, baseClassKey, modifier);
+            newClass.setStrength(strength);
+            newClass.setStrengthDirection(direction);
+            return newClass.key;
+        }
+        catch (e) {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.CreateSchemaItemFailed, new Exception_1.ClassId(this.schemaItemType, name, schemaKey), e);
         }
-        newClass.setStrength(strength);
-        newClass.setStrengthDirection(direction);
-        return { itemKey: newClass.key };
     }
     /**
      * Sets the source RelationshipConstraint on the relationship.
      * @param relationshipKey The SchemaItemKey for the relationship.
      * @param source The RelationshipConstraint to add.
-     * @returns A promise of type SchemaItemEditResults.
      */
     async setSourceConstraint(relationshipKey, source) {
-        const relationship = (await this._schemaEditor.schemaContext.getSchemaItem(relationshipKey));
-        if (relationship === undefined)
-            return { itemKey: relationshipKey, errorMessage: `Relationship Class ${relationshipKey.fullName} not found in schema context.` };
+        const relationship = await this.getSchemaItem(relationshipKey)
+            .catch((e) => {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.SetSourceConstraint, new Exception_1.ClassId(this.schemaItemType, relationshipKey), e);
+        });
         relationship.setSourceConstraint(source);
-        return { itemKey: relationshipKey };
     }
     /**
      * Sets the target RelationshipConstraint on the relationship.
      * @param relationshipKey The SchemaItemKey for the relationship.
      * @param target The RelationshipConstraint to add.
-     * @returns A promise of type SchemaItemEditResults.
      */
     async setTargetConstraint(relationshipKey, target) {
-        const relationship = await this._schemaEditor.schemaContext.getSchemaItem(relationshipKey);
-        if (relationship === undefined)
-            return { itemKey: relationshipKey, errorMessage: `Relationship Class ${relationshipKey.fullName} not found in schema context.` };
+        const relationship = await this.getSchemaItem(relationshipKey)
+            .catch((e) => {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.SetTargetConstraint, new Exception_1.ClassId(this.schemaItemType, relationshipKey), e);
+        });
         relationship.setTargetConstraint(target);
-        return { itemKey: relationshipKey };
     }
     /**
      * Creates a RelationshipClass through a RelationshipClassProps.
@@ -87,16 +75,15 @@ class RelationshipClasses extends ECClasses_1.ECClasses {
      * @param relationshipProps a json object that will be used to populate the new RelationshipClass. Needs a name value passed in.
      */
     async createFromProps(schemaKey, relationshipProps) {
-        const schema = await this._schemaEditor.getSchema(schemaKey);
-        if (schema === undefined)
-            return { errorMessage: `Schema Key ${schemaKey.toString(true)} not found in context` };
-        if (relationshipProps.name === undefined)
-            return { errorMessage: `No name was supplied within props.` };
-        const newClass = (await schema.createRelationshipClass(relationshipProps.name));
-        await newClass.fromJSON(relationshipProps);
-        await newClass.source.fromJSON(relationshipProps.source);
-        await newClass.target.fromJSON(relationshipProps.target);
-        return { itemKey: newClass.key };
+        try {
+            const newClass = await this.createSchemaItemFromProps(schemaKey, this.schemaItemType, (schema) => schema.createRelationshipClass.bind(schema), relationshipProps);
+            await newClass.source.fromJSON(relationshipProps.source);
+            await newClass.target.fromJSON(relationshipProps.target);
+            return newClass.key;
+        }
+        catch (e) {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.CreateSchemaItemFromProps, new Exception_1.ClassId(this.schemaItemType, relationshipProps.name, schemaKey), e);
+        }
     }
     /**
      * Sets the base class of a RelationshipClass.
@@ -104,26 +91,25 @@ class RelationshipClasses extends ECClasses_1.ECClasses {
      * @param baseClassKey The SchemaItemKey of the base class. Specifying 'undefined' removes the base class.
      */
     async setBaseClass(itemKey, baseClassKey) {
-        const relClass = await this._schemaEditor.schemaContext.getSchemaItem(itemKey);
+        const relClass = await this.schemaEditor.schemaContext.getSchemaItem(itemKey);
         const baseClass = relClass?.baseClass;
-        const setResult = await super.setBaseClass(itemKey, baseClassKey);
-        if (setResult.errorMessage === undefined) {
-            const result = await this.validate(relClass);
-            if (result.errorMessage !== undefined) {
-                relClass.baseClass = baseClass;
-                return { itemKey, errorMessage: result.errorMessage };
-            }
+        await super.setBaseClass(itemKey, baseClassKey);
+        try {
+            await this.validate(relClass);
+        }
+        catch (e) {
+            relClass.baseClass = baseClass;
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.SetBaseClass, new Exception_1.ClassId(ecschema_metadata_1.SchemaItemType.RelationshipClass, itemKey), e);
         }
-        return setResult;
     }
     async createNavigationProperty(relationshipKey, name, relationship, direction) {
-        const relationshipClass = (await this._schemaEditor.schemaContext.getSchemaItem(relationshipKey));
-        if (relationshipClass === undefined)
-            return { itemKey: relationshipKey, propertyName: name, errorMessage: `Relationship Class ${relationshipKey.fullName} not found in schema context.` };
-        if (relationshipClass.schemaItemType !== ecschema_metadata_1.SchemaItemType.RelationshipClass)
-            return { itemKey: relationshipKey, propertyName: name, errorMessage: `Expected ${relationshipKey.fullName} to be of type Relationship Class.` };
-        await relationshipClass.createNavigationProperty(name, relationship, direction);
-        return { itemKey: relationshipKey, propertyName: name };
+        try {
+            const relationshipClass = await this.getSchemaItem(relationshipKey);
+            await relationshipClass.createNavigationProperty(name, relationship, direction);
+        }
+        catch (e) {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.CreateNavigationProperty, new Exception_1.ClassId(ecschema_metadata_1.SchemaItemType.RelationshipClass, relationshipKey), e);
+        }
     }
     /**
      * Creates a Navigation Property through a NavigationPropertyProps.
@@ -131,29 +117,26 @@ class RelationshipClasses extends ECClasses_1.ECClasses {
      * @param navigationProps a json object that will be used to populate the new Navigation Property.
      */
     async createNavigationPropertyFromProps(relationshipKey, navigationProps) {
-        const relationshipClass = await this._schemaEditor.schemaContext.getSchemaItem(relationshipKey);
-        if (relationshipClass === undefined)
-            return { itemKey: relationshipKey, propertyName: navigationProps.name, errorMessage: `Relationship Class ${relationshipKey.fullName} not found in schema context.` };
-        if (relationshipClass.schemaItemType !== ecschema_metadata_1.SchemaItemType.RelationshipClass)
-            return { itemKey: relationshipKey, propertyName: navigationProps.name, errorMessage: `Expected ${relationshipKey.fullName} to be of type Relationship Class.` };
-        const property = await relationshipClass.createNavigationProperty(navigationProps.name, navigationProps.relationshipName, navigationProps.direction);
-        await property.fromJSON(navigationProps);
-        return { itemKey: relationshipKey, propertyName: navigationProps.name };
+        try {
+            const relationshipClass = await this.getSchemaItem(relationshipKey);
+            const property = await relationshipClass.createNavigationProperty(navigationProps.name, navigationProps.relationshipName, navigationProps.direction);
+            await property.fromJSON(navigationProps);
+        }
+        catch (e) {
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.CreateNavigationPropertyFromProps, new Exception_1.ClassId(ecschema_metadata_1.SchemaItemType.RelationshipClass, relationshipKey), e);
+        }
     }
     async setConstraintMultiplicity(constraint, multiplicity) {
         const mutableConstraint = constraint;
         mutableConstraint.multiplicity = multiplicity;
-        return { itemKey: constraint.relationshipClass.key };
     }
     async setConstraintPolymorphic(constraint, polymorphic) {
         const mutableConstraint = constraint;
         mutableConstraint.polymorphic = polymorphic;
-        return { itemKey: constraint.relationshipClass.key };
     }
     async setConstraintRelationshipEnd(constraint, relationshipEnd) {
         const mutableConstraint = constraint;
         mutableConstraint.relationshipEnd = relationshipEnd;
-        return { itemKey: constraint.relationshipClass.key };
     }
     async setAbstractConstraint(constraint, abstractConstraint) {
         const existing = constraint.abstractConstraint;
@@ -164,73 +147,86 @@ class RelationshipClasses extends ECClasses_1.ECClasses {
         else {
             mutableConstraint.abstractConstraint = new ecschema_metadata_1.DelayedPromiseWithProps(abstractConstraint.key, async () => abstractConstraint);
         }
-        let result = await this.validate(constraint.relationshipClass);
-        if (result.errorMessage) {
+        try {
+            await this.validate(constraint.relationshipClass);
+        }
+        catch (e) {
             mutableConstraint.abstractConstraint = existing;
-            return result;
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.SetAbstractConstraint, new Exception_1.RelationshipConstraintId(constraint), e);
         }
-        result = await this.validate(constraint);
-        if (result.errorMessage) {
+        try {
+            await this.validate(constraint);
+        }
+        catch (e) {
             mutableConstraint.abstractConstraint = existing;
-            return result;
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.SetAbstractConstraint, new Exception_1.RelationshipConstraintId(constraint), e);
         }
-        return { itemKey: constraint.relationshipClass.key };
     }
     async addConstraintClass(constraint, ecClass) {
         const mutableConstraint = constraint;
         mutableConstraint.addClass(ecClass);
-        let result = await this.validate(constraint.relationshipClass);
-        if (result.errorMessage) {
+        try {
+            await this.validate(constraint.relationshipClass);
+        }
+        catch (e) {
             mutableConstraint.removeClass(ecClass);
-            return result;
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.AddConstraintClass, new Exception_1.RelationshipConstraintId(constraint), e);
         }
-        result = await this.validate(constraint);
-        if (result.errorMessage) {
+        try {
+            await this.validate(constraint);
+        }
+        catch (e) {
             mutableConstraint.removeClass(ecClass);
-            return result;
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.AddConstraintClass, new Exception_1.RelationshipConstraintId(constraint), e);
         }
-        return { itemKey: constraint.relationshipClass.key };
     }
     async removeConstraintClass(constraint, ecClass) {
         const mutableConstraint = constraint;
         mutableConstraint.removeClass(ecClass);
-        const result = await this.validate(constraint);
-        if (result.errorMessage) {
+        try {
+            await this.validate(constraint);
+        }
+        catch (e) {
             mutableConstraint.addClass(ecClass);
-            return result;
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.RemoveConstraintClass, new Exception_1.RelationshipConstraintId(constraint), e);
         }
-        return { itemKey: constraint.relationshipClass.key };
     }
     async addCustomAttributeToConstraint(constraint, customAttribute) {
         const mutableConstraint = constraint;
         mutableConstraint.addCustomAttribute(customAttribute);
-        const diagnostics = Rules.validateCustomAttributeInstance(constraint, customAttribute);
-        const result = { errorMessage: "" };
-        for await (const diagnostic of diagnostics) {
-            result.errorMessage += `${diagnostic.code}: ${diagnostic.messageText}\r\n`;
+        const diagnosticIterable = Rules.validateCustomAttributeInstance(constraint, customAttribute);
+        const diagnostics = [];
+        for await (const diagnostic of diagnosticIterable) {
+            diagnostics.push(diagnostic);
         }
-        if (result.errorMessage) {
+        if (diagnostics.length > 0) {
             this.removeCustomAttribute(constraint, customAttribute);
-            return result;
+            throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.AddCustomAttributeToConstraint, new Exception_1.RelationshipConstraintId(constraint), new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.RuleViolation, new Exception_1.CustomAttributeId(customAttribute.className, constraint), undefined, diagnostics));
         }
-        return { itemKey: constraint.relationshipClass.key };
     }
     async validate(relationshipOrConstraint) {
-        let diagnostics;
+        let diagnosticIterable;
+        let relationshipKey;
         if (relationshipOrConstraint instanceof ecschema_metadata_1.RelationshipClass) {
-            diagnostics = Rules.validateRelationship(relationshipOrConstraint);
+            diagnosticIterable = Rules.validateRelationship(relationshipOrConstraint);
+            relationshipKey = relationshipOrConstraint.key;
         }
         else {
-            diagnostics = Rules.validateRelationshipConstraint(relationshipOrConstraint);
+            diagnosticIterable = Rules.validateRelationshipConstraint(relationshipOrConstraint);
+            relationshipKey = relationshipOrConstraint.relationshipClass.key;
         }
-        const errorMessages = [];
-        for await (const diagnostic of diagnostics) {
-            errorMessages.push(`${diagnostic.code}: ${diagnostic.messageText}`);
+        const diagnostics = [];
+        for await (const diagnostic of diagnosticIterable) {
+            diagnostics.push(diagnostic);
         }
-        if (errorMessages.length > 0) {
-            return { errorMessage: errorMessages.join("\r\n") };
+        if (diagnostics.length > 0) {
+            if (relationshipOrConstraint instanceof ecschema_metadata_1.RelationshipClass) {
+                throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.RuleViolation, new Exception_1.ClassId(ecschema_metadata_1.SchemaItemType.RelationshipClass, relationshipKey), undefined, diagnostics);
+            }
+            else {
+                throw new Exception_1.SchemaEditingError(Exception_1.ECEditingStatus.RuleViolation, new Exception_1.RelationshipConstraintId(relationshipOrConstraint), undefined, diagnostics);
+            }
         }
-        return {};
     }
 }
 exports.RelationshipClasses = RelationshipClasses;