@itwin/ecschema-metadata 5.0.0-dev.98 → 5.0.0

package/lib/cjs/Metadata/Schema.js

@@ -34,7 +34,7 @@ const Unit_1 = require("./Unit");
 const UnitSystem_1 = require("./UnitSystem");
 const Constants_1 = require("../Constants");
 /**
- * @beta
+ * @public @preview
  */
 class Schema {
     static _currentECSpecVersion = "3.2";
@@ -58,34 +58,34 @@ class Schema {
             this._alias = alias;
         }
         else if (nameOrKey !== undefined) {
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The Schema ${this.name} does not have the required 'alias' attribute.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The Schema ${this.name} does not have the required 'alias' attribute.`);
         }
         this._originalECSpecMajorVersion = Schema.currentECSpecMajorVersion;
         this._originalECSpecMinorVersion = Schema.currentECSpecMinorVersion;
     }
     get schemaKey() {
         if (undefined === this._schemaKey)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
         return this._schemaKey;
     }
     get name() {
         if (this._schemaKey === undefined)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
         return this.schemaKey.name;
     }
     get readVersion() {
         if (this._schemaKey === undefined)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
         return this.schemaKey.readVersion;
     }
     get writeVersion() {
         if (this._schemaKey === undefined)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
         return this.schemaKey.writeVersion;
     }
     get minorVersion() {
         if (this._schemaKey === undefined)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The schema has an invalid or missing SchemaKey.`);
         return this.schemaKey.minorVersion;
     }
     get originalECSpecMajorVersion() { return this._originalECSpecMajorVersion; }
@@ -98,7 +98,7 @@ class Schema {
     }
     get alias() {
         if (this._alias === undefined || this._alias === null) {
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The Schema ${this.name} does not have the required 'alias' attribute.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The Schema ${this.name} does not have the required 'alias' attribute.`);
         }
         else {
             return this._alias;
@@ -123,18 +123,19 @@ class Schema {
         if (this.name !== schemaName) {
             const newSchemaRef = this.getReferenceSync(schemaName);
             if (undefined === newSchemaRef)
-                throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `Unable to find the referenced SchemaItem ${itemName}.`);
+                throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `Unable to find the referenced SchemaItem ${itemName}.`);
             schemaKey = newSchemaRef.schemaKey;
         }
         return new SchemaKey_1.SchemaItemKey(itemName, schemaKey);
     }
+    /** @internal */
     addItem(item) {
         if (undefined !== this.getItemSync(item.name))
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.DuplicateItem, `The SchemaItem ${item.name} cannot be added to the schema ${this.name} because it already exists`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.DuplicateItem, `The SchemaItem ${item.name} cannot be added to the schema ${this.name} because it already exists`);
         this._items.set(item.name.toUpperCase(), item);
     }
     /**
-     * @alpha
+     * @internal
      */
     createClass(type, name, modifier) {
         const item = new type(this, name, modifier);
@@ -144,7 +145,7 @@ class Schema {
     /**
      * Deletes a class from within this schema.
      * @param name the local (unqualified) class name, lookup is case-insensitive
-     * @alpha
+     * @internal
      */
     async deleteClass(name) {
         const schemaItem = await this.getItem(name);
@@ -155,7 +156,7 @@ class Schema {
     /**
      * Deletes a class from within this schema.
      * @param name the local (unqualified) class name, lookup is case-insensitive
-     * @alpha
+     * @internal
      */
     deleteClassSync(name) {
         const schemaItem = this.getItemSync(name);
@@ -165,7 +166,7 @@ class Schema {
     /**
      * Deletes a SchemaItem from within this schema.
      * @param name the local (unqualified) class name, lookup is case-insensitive
-     * @alpha
+     * @internal
      */
     async deleteSchemaItem(name) {
         const schemaItem = await this.getItem(name);
@@ -176,21 +177,20 @@ class Schema {
     /**
      * Deletes a SchemaItem from within this schema.
      * @param name the local (unqualified) class name, lookup is case-insensitive
-     * @alpha
+     * @internal
      */
     deleteSchemaItemSync(name) {
         const schemaItem = this.getItemSync(name);
         if (SchemaItem_1.SchemaItem.isSchemaItem(schemaItem))
             this._items.delete(name.toUpperCase());
     }
-    /**
-     * @alpha
-     */
+    /** @internal */
     createItem(type, name) {
         const item = new type(this, name);
         this.addItem(item);
         return item;
     }
+    /** @internal */
     addCustomAttribute(customAttribute) {
         if (!this._customAttributes)
             this._customAttributes = new Map();
@@ -200,27 +200,33 @@ class Schema {
      * Creates a EntityClass with the provided name in this schema.
      * @param name
      * @param modifier
+     * @internal
      */
     async createEntityClass(name, modifier) {
         return this.createClass(EntityClass_1.EntityClass, name, modifier);
     }
+    /** @internal */
     createEntityClassSync(name, modifier) {
         return this.createClass(EntityClass_1.EntityClass, name, modifier);
     }
     /**
      * Creates a Mixin with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createMixinClass(name) { return this.createClass(Mixin_1.Mixin, name); }
+    /** @internal */
     createMixinClassSync(name) { return this.createClass(Mixin_1.Mixin, name); }
     /**
      * Creates a StructClass with the provided name in this schema.
      * @param name
      * @param modifier
+     * @internal
      */
     async createStructClass(name, modifier) {
         return this.createClass(Class_1.StructClass, name, modifier);
     }
+    /** @internal */
     createStructClassSync(name, modifier) {
         return this.createClass(Class_1.StructClass, name, modifier);
     }
@@ -228,10 +234,12 @@ class Schema {
      * Creates a CustomAttributeClass with the provided name in this schema.
      * @param name
      * @param modifier
+     * @internal
      */
     async createCustomAttributeClass(name, modifier) {
         return this.createClass(CustomAttributeClass_1.CustomAttributeClass, name, modifier);
     }
+    /** @internal */
     createCustomAttributeClassSync(name, modifier) {
         return this.createClass(CustomAttributeClass_1.CustomAttributeClass, name, modifier);
     }
@@ -239,20 +247,26 @@ class Schema {
      * Creates a RelationshipClass with the provided name in this schema.
      * @param name
      * @param modifier
+     * @internal
      */
     async createRelationshipClass(name, modifier) {
         return this.createRelationshipClassSync(name, modifier);
     }
+    /** @internal */
     createRelationshipClassSync(name, modifier) {
         return this.createClass(RelationshipClass_1.RelationshipClass, name, modifier);
     }
     /**
      * Creates an Enumeration with the provided name in this schema.
      * @param name
+     * @param primitiveType
+     *
+     * @internal
      */
     async createEnumeration(name, primitiveType) {
         return this.createEnumerationSync(name, primitiveType);
     }
+    /** @internal */
     createEnumerationSync(name, primitiveType) {
         const item = new Enumeration_1.Enumeration(this, name, primitiveType);
         this.addItem(item);
@@ -261,97 +275,113 @@ class Schema {
     /**
      * Creates an KindOfQuantity with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createKindOfQuantity(name) {
         return this.createKindOfQuantitySync(name);
     }
+    /** @internal */
     createKindOfQuantitySync(name) {
         return this.createItem(KindOfQuantity_1.KindOfQuantity, name);
     }
     /**
      * Creates a Constant with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createConstant(name) {
         return this.createItem(Constant_1.Constant, name);
     }
+    /** @internal */
     createConstantSync(name) {
         return this.createItem(Constant_1.Constant, name);
     }
     /**
      * Creates a Inverted Unit with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createInvertedUnit(name) {
         return this.createItem(InvertedUnit_1.InvertedUnit, name);
     }
+    /** @internal */
     createInvertedUnitSync(name) {
         return this.createItem(InvertedUnit_1.InvertedUnit, name);
     }
     /**
      * Creates an Format with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createFormat(name) {
         return this.createItem(Format_1.Format, name);
     }
+    /** @internal */
     createFormatSync(name) {
         return this.createItem(Format_1.Format, name);
     }
     /**
      * Creates a UnitSystem with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createUnitSystem(name) {
         return this.createItem(UnitSystem_1.UnitSystem, name);
     }
+    /** @internal */
     createUnitSystemSync(name) {
         return this.createItem(UnitSystem_1.UnitSystem, name);
     }
     /**
      * Creates a Phenomenon with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createPhenomenon(name) {
         return this.createItem(Phenomenon_1.Phenomenon, name);
     }
+    /** @internal */
     createPhenomenonSync(name) {
         return this.createItem(Phenomenon_1.Phenomenon, name);
     }
     /**
      * Creates a Unit with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createUnit(name) {
         return this.createItem(Unit_1.Unit, name);
     }
+    /** @internal */
     createUnitSync(name) {
         return this.createItem(Unit_1.Unit, name);
     }
     /**
      * Creates an PropertyCategory with the provided name in this schema.
      * @param name
+     * @internal
      */
     async createPropertyCategory(name) {
         return this.createItem(PropertyCategory_1.PropertyCategory, name);
     }
+    /** @internal */
     createPropertyCategorySync(name) {
         return this.createItem(PropertyCategory_1.PropertyCategory, name);
     }
     /**
      *
      * @param refSchema
+     * @internal
      */
     async addReference(refSchema) {
         // TODO validation of reference schema. For now just adding
         this.addReferenceSync(refSchema);
     }
+    /** @internal */
     addReferenceSync(refSchema) {
         this.references.push(refSchema);
     }
-    /**
-     * @alpha Used for schema editing.
-     */
+    /** @internal */
     setContext(context) {
         this._context = context;
     }
@@ -360,10 +390,11 @@ class Schema {
      * @param readVersion The read version of the schema. If undefined, the value from the existing SchemaKey will be used.
      * @param writeVersion The write version of the schema. If undefined, the value from the existing SchemaKey will be used.
      * @param minorVersion The minor version of the schema. If undefined, the value from the existing SchemaKey will be used.
+     * @internal
      */
     setVersion(readVersion, writeVersion, minorVersion) {
         if (!this._schemaKey)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidSchemaKey, `The schema '${this.name}' has an invalid SchemaKey.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidSchemaKey, `The schema '${this.name}' has an invalid SchemaKey.`);
         const newVersion = new SchemaKey_1.ECVersion(readVersion ?? this._schemaKey.readVersion, writeVersion ?? this._schemaKey.writeVersion, minorVersion ?? this._schemaKey.minorVersion);
         this._schemaKey = new SchemaKey_1.SchemaKey(this._schemaKey.name, newVersion);
     }
@@ -548,7 +579,7 @@ class Schema {
      */
     toJSON() {
         if (this._isECSpecVersionUnsupported)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.NewerECSpecVersion, `The Schema '${this.name}' has an unsupported ECSpecVersion and cannot be serialized.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.NewerECSpecVersion, `The Schema '${this.name}' has an unsupported ECSpecVersion and cannot be serialized.`);
         const schemaJson = {};
         schemaJson.$schema = Constants_1.ECSchemaNamespaceUris.SCHEMAURL3_2_JSON; // $schema is required
         schemaJson.name = this.name; // name is required
@@ -577,7 +608,7 @@ class Schema {
      */
     async toXml(schemaXml) {
         if (this._isECSpecVersionUnsupported)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.NewerECSpecVersion, `The Schema '${this.name}' has an unsupported ECSpecVersion and cannot be serialized.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.NewerECSpecVersion, `The Schema '${this.name}' has an unsupported ECSpecVersion and cannot be serialized.`);
         const schemaMetadata = schemaXml.createElement("ECSchema");
         schemaMetadata.setAttribute("xmlns", Constants_1.ECSchemaNamespaceUris.SCHEMAURL3_2_XML);
         schemaMetadata.setAttribute("version", this.schemaKey.version.toString());
@@ -623,12 +654,12 @@ class Schema {
         }
         else {
             if (schemaProps.name.toLowerCase() !== this.name.toLowerCase())
-                throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The Schema ${this.name} does not match the provided name, '${schemaProps.name}'.`);
+                throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The Schema ${this.name} does not match the provided name, '${schemaProps.name}'.`);
             if (this.schemaKey.version.compare(SchemaKey_1.ECVersion.fromString(schemaProps.version)))
-                throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The Schema ${this.name} has the version '${this.schemaKey.version}' that does not match the provided version '${schemaProps.version}'.`);
+                throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The Schema ${this.name} has the version '${this.schemaKey.version}' that does not match the provided version '${schemaProps.version}'.`);
         }
         if (schemaProps.$schema.match(`https://dev\\.bentley\\.com/json_schemas/ec/([0-9]+)/ecschema`) == null && schemaProps.$schema.match(`http://www\\.bentley\\.com/schemas/Bentley\\.ECXML\\.([0-9]+)`) == null)
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.MissingSchemaUrl, `The Schema '${this.name}' has an unsupported namespace '${schemaProps.$schema}'.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.MissingSchemaUrl, `The Schema '${this.name}' has an unsupported namespace '${schemaProps.$schema}'.`);
         // The schema props have not been parsed. Parse the ECXml version from the $schema attribute
         let ecVersion;
         if (schemaProps.ecSpecMajorVersion === undefined || schemaProps.ecSpecMinorVersion === undefined) {
@@ -640,12 +671,12 @@ class Schema {
         this._originalECSpecMajorVersion = ecVersion.readVersion;
         this._originalECSpecMinorVersion = ecVersion.writeVersion;
         if (ecVersion.readVersion !== 3 || (ecVersion.readVersion === 3 && ecVersion.writeVersion < 2))
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECVersion, `The Schema '${this.name}' has an unsupported ECVersion ${ecVersion.readVersion}.${ecVersion.writeVersion} and cannot be loaded.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECVersion, `The Schema '${this.name}' has an unsupported ECVersion ${ecVersion.readVersion}.${ecVersion.writeVersion} and cannot be loaded.`);
         if (ECName_1.ECName.validate(schemaProps.alias)) {
             this._alias = schemaProps.alias;
         }
         else {
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECJson, `The Schema ${schemaProps.name} does not have the required 'alias' attribute.`);
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECJson, `The Schema ${schemaProps.name} does not have the required 'alias' attribute.`);
         }
         if (undefined !== schemaProps.label)
             this._label = schemaProps.label;
@@ -692,27 +723,18 @@ class Schema {
         const schema = object;
         return schema !== undefined && schema.schemaKey !== undefined && schema.context !== undefined;
     }
-    /**
-     * @alpha
-     * Used for schema editing.
-     */
+    /** @internal */
     setDisplayLabel(displayLabel) {
         this._label = displayLabel;
     }
-    /**
-     * @alpha
-     * Used for schema editing.
-     */
+    /** @internal */
     setDescription(description) {
         this._description = description;
     }
-    /**
-     * @alpha
-     * Used for schema editing.
-     */
+    /** @internal */
     setAlias(alias) {
         if (!ECName_1.ECName.validate(alias)) {
-            throw new Exception_1.ECObjectsError(Exception_1.ECObjectsStatus.InvalidECName, "The specified schema alias is invalid.");
+            throw new Exception_1.ECSchemaError(Exception_1.ECSchemaStatus.InvalidECName, "The specified schema alias is invalid.");
         }
         this._alias = alias;
     }