@itwin/ecschema-editing 5.0.0-dev.90 → 5.0.0-dev.93

package/lib/esm/Merging/PropertyMerger.js

@@ -0,0 +1,228 @@
+import { Enumeration, parsePrimitiveType, RelationshipClass, SchemaItemKey, SchemaItemType, StructClass } from "@itwin/ecschema-metadata";
+import { getClassEditor, toItemKey, toPropertyKey, updateSchemaItemFullName, updateSchemaItemKey } from "./Utils";
+import { applyCustomAttributes } from "./CustomAttributeMerger";
+/**
+ * @internal
+ */
+export async function mergePropertyDifference(context, change) {
+    const classKey = new SchemaItemKey(change.itemName, context.targetSchemaKey);
+    return mergeClassProperty(context, change, classKey, {
+        ...change.difference,
+        name: change.path,
+    });
+}
+/**
+ * @internal
+ */
+export async function mergeClassProperties(context, change, itemKey) {
+    for (const property of change.difference.properties || []) {
+        await mergeClassProperty(context, change, itemKey, property);
+    }
+}
+async function mergeClassProperty(context, change, itemKey, property) {
+    return change.changeType === "add"
+        ? addClassProperty(context, itemKey, property)
+        : modifyClassProperty(context, itemKey, property);
+}
+async function addClassProperty(context, itemKey, property) {
+    const ecClass = await context.targetSchema.lookupItem(toItemKey(context, itemKey.name));
+    if (property.category !== undefined) {
+        property.category = await updateSchemaItemFullName(context, property.category);
+    }
+    if (property.kindOfQuantity !== undefined) {
+        property.kindOfQuantity = await updateSchemaItemFullName(context, property.kindOfQuantity);
+    }
+    await createProperty(context, ecClass.key, property);
+    if (property.customAttributes !== undefined) {
+        await applyCustomAttributes(context, property.customAttributes, async (ca) => {
+            const classEditor = await getClassEditor(context, ecClass.key);
+            await classEditor.properties.addCustomAttribute(ecClass.key, property.name, ca);
+        });
+    }
+}
+async function createProperty(context, itemKey, property) {
+    if (enumerationProperty.is(property)) {
+        return enumerationProperty.add(context, itemKey, property);
+    }
+    if (navigationProperty.is(property)) {
+        return navigationProperty.add(context, itemKey, property);
+    }
+    if (primitiveProperty.is(property)) {
+        return primitiveProperty.add(context, itemKey, property);
+    }
+    if (structProperty.is(property)) {
+        return structProperty.add(context, itemKey, property);
+    }
+    return {};
+}
+async function modifyClassProperty(context, itemKey, propertyProps) {
+    const ecClass = await context.targetSchema.lookupItem(toItemKey(context, itemKey.name));
+    const propertyKey = toPropertyKey(context, itemKey.name, propertyProps.name);
+    const property = await ecClass.getProperty(propertyKey.propertyName);
+    if (property === undefined) {
+        throw new Error(`Couldn't find property ${propertyKey.propertyName} on class ${ecClass.key.name}`);
+    }
+    if (propertyProps.type !== undefined) {
+        throw new Error(`Changing the property '${property.fullName}' type is not supported.`);
+    }
+    const classEditor = await getClassEditor(context, ecClass);
+    if (propertyProps.description !== undefined) {
+        await classEditor.properties.setDescription(ecClass.key, property.name, propertyProps.description);
+    }
+    if (propertyProps.label !== undefined) {
+        await classEditor.properties.setLabel(ecClass.key, property.name, propertyProps.label);
+    }
+    if (propertyProps.isReadOnly !== undefined) {
+        await classEditor.properties.setIsReadOnly(ecClass.key, property.name, propertyProps.isReadOnly);
+    }
+    if (propertyProps.priority !== undefined) {
+        await classEditor.properties.setPriority(ecClass.key, property.name, propertyProps.priority);
+    }
+    if (propertyProps.kindOfQuantity !== undefined) {
+        await classEditor.properties.setKindOfQuantity(ecClass.key, property.name, await updateSchemaItemKey(context, propertyProps.kindOfQuantity));
+    }
+    if (property.isArray()) {
+        await arrayProperty.merge(context, ecClass.key, property.name, propertyProps);
+    }
+    if (propertyProps.category !== undefined) {
+        const categoryKey = await updateSchemaItemKey(context, propertyProps.category);
+        await classEditor.properties.setCategory(ecClass.key, property.name, categoryKey);
+    }
+    if (property.isEnumeration()) {
+        return enumerationProperty.merge(context, ecClass.key, property, propertyProps);
+    }
+    if (property.isNavigation()) {
+        return navigationProperty.merge(context, ecClass.key, property, propertyProps);
+    }
+    if (property.isPrimitive()) {
+        return primitiveProperty.merge(context, ecClass.key, property, propertyProps);
+    }
+    if (property.isStruct()) {
+        return structProperty.merge(context, ecClass.key, property, propertyProps);
+    }
+}
+const arrayProperty = {
+    is(property) {
+        return "minOccurs" in property && "maxOccurs" in property;
+    },
+    async merge(context, itemKey, propertyName, props) {
+        const classEditor = await getClassEditor(context, itemKey);
+        if (props.minOccurs !== undefined) {
+            await classEditor.arrayProperties.setMinOccurs(itemKey, propertyName, props.minOccurs);
+        }
+        if (props.maxOccurs !== undefined) {
+            await classEditor.arrayProperties.setMaxOccurs(itemKey, propertyName, props.maxOccurs);
+        }
+    },
+};
+const enumerationProperty = {
+    is(property) {
+        return primitiveProperty.is(property) && property.typeName.includes(".");
+    },
+    async add(context, itemKey, property) {
+        const enumerationKey = await updateSchemaItemKey(context, property.typeName);
+        const enumerationType = await context.editor.schemaContext.getSchemaItem(enumerationKey, Enumeration);
+        if (enumerationType === undefined) {
+            throw new Error(`Unable to locate the enumeration class ${enumerationKey.name} in the context schema.`);
+        }
+        property.typeName = enumerationType.fullName;
+        const classEditor = await getClassEditor(context, itemKey);
+        arrayProperty.is(property)
+            ? await classEditor.createEnumerationArrayPropertyFromProps(itemKey, property.name, enumerationType, property)
+            : await classEditor.createEnumerationPropertyFromProps(itemKey, property.name, enumerationType, property);
+    },
+    async merge(context, itemKey, property, props) {
+        if ("enumeration" in props && props.enumeration !== undefined) {
+            throw new Error(`Changing the property '${property.fullName}' enumeration is not supported.`);
+        }
+        return primitiveProperty.merge(context, itemKey, property, props);
+    },
+};
+const navigationProperty = {
+    is(property) {
+        return property.type === "NavigationProperty";
+    },
+    async add(context, itemKey, property) {
+        const relationshipKey = await updateSchemaItemKey(context, property.relationshipName);
+        const relationshipType = await context.editor.schemaContext.getSchemaItem(relationshipKey, RelationshipClass);
+        if (relationshipType === undefined) {
+            throw new Error(`Unable to locate the relationship class ${relationshipKey.name} in the context schema.`);
+        }
+        property.relationshipName = relationshipType.fullName;
+        const ecClass = await context.editor.schemaContext.getSchemaItem(itemKey);
+        if (ecClass.schemaItemType === SchemaItemType.EntityClass)
+            return context.editor.entities.createNavigationPropertyFromProps(ecClass.key, property);
+        if (ecClass.schemaItemType === SchemaItemType.Mixin)
+            return context.editor.mixins.createNavigationPropertyFromProps(ecClass.key, property);
+        if (ecClass.schemaItemType === SchemaItemType.RelationshipClass)
+            return context.editor.relationships.createNavigationPropertyFromProps(ecClass.key, property);
+        throw new Error(`Navigation property can't be added to ${ecClass.schemaItemType}.`);
+    },
+    async merge(_context, _itemKey, property, props) {
+        if (props.direction !== undefined) {
+            throw new Error(`Changing the property '${property.fullName}' direction is not supported.`);
+        }
+        if ("relationshipClass" in props && props.relationshipClass !== undefined) {
+            throw new Error(`Changing the property '${property.fullName}' relationship class is not supported.`);
+        }
+    },
+};
+const primitiveProperty = {
+    is(property) {
+        return property.type === "PrimitiveProperty" || property.type === "PrimitiveArrayProperty";
+    },
+    async add(context, itemKey, property) {
+        const propertyType = parsePrimitiveType(property.typeName);
+        if (propertyType === undefined) {
+            throw new Error(`Invalid property type ${property.typeName} on property ${property.name}`);
+        }
+        const classEditor = await getClassEditor(context, itemKey);
+        return arrayProperty.is(property)
+            ? classEditor.createPrimitiveArrayPropertyFromProps(itemKey, property.name, propertyType, property)
+            : classEditor.createPrimitivePropertyFromProps(itemKey, property.name, propertyType, property);
+    },
+    async merge(context, itemKey, property, props) {
+        if (props.typeName) {
+            throw new Error(`Changing the property '${property.fullName}' primitiveType is not supported.`);
+        }
+        const classEditor = await getClassEditor(context, itemKey);
+        if (props.extendedTypeName !== undefined) {
+            await classEditor.primitiveProperties.setExtendedTypeName(itemKey, property.name, props.extendedTypeName);
+        }
+        if (props.minLength !== undefined) {
+            await classEditor.primitiveProperties.setMinLength(itemKey, property.name, props.minLength);
+        }
+        if (props.maxLength !== undefined) {
+            await classEditor.primitiveProperties.setMaxLength(itemKey, property.name, props.maxLength);
+        }
+        if (props.minValue !== undefined) {
+            await classEditor.primitiveProperties.setMinValue(itemKey, property.name, props.minValue);
+        }
+        if (props.maxValue !== undefined) {
+            await classEditor.primitiveProperties.setMaxValue(itemKey, property.name, props.maxValue);
+        }
+    },
+};
+const structProperty = {
+    is(property) {
+        return property.type === "StructProperty" || property.type === "StructArrayProperty";
+    },
+    async add(context, itemKey, property) {
+        const structKey = await updateSchemaItemKey(context, property.typeName);
+        const structType = await context.editor.schemaContext.getSchemaItem(structKey, StructClass);
+        if (structType === undefined) {
+            throw new Error(`Unable to locate the struct ${structKey.name} in the context schema.`);
+        }
+        property.typeName = structType.fullName;
+        const classEditor = await getClassEditor(context, itemKey);
+        return arrayProperty.is(property)
+            ? classEditor.createStructArrayPropertyFromProps(itemKey, property.name, structType, property)
+            : classEditor.createStructPropertyFromProps(itemKey, property.name, structType, property);
+    },
+    async merge(_context, _itemKey, property, props) {
+        if ("structClass" in props && props.structClass !== undefined) {
+            throw new Error(`Changing the property '${property.fullName}' structClass is not supported.`);
+        }
+    },
+};
+//# sourceMappingURL=PropertyMerger.js.map

package/lib/esm/Merging/PropertyMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PropertyMerger.js","sourceRoot":"","sources":["../../../src/Merging/PropertyMerger.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*--------------------------------------------------------------------------------------------*/\nimport type { SchemaMergeContext } from \"./SchemaMerger\";\nimport type { AnyClassItemDifference, ClassPropertyDifference, DifferenceType } from \"../Differencing/SchemaDifference\";\nimport { AnyProperty, AnyPropertyProps, ArrayPropertyProps, CustomAttribute, ECClass, Enumeration, EnumerationPropertyProps, NavigationPropertyProps, parsePrimitiveType, PrimitivePropertyProps, RelationshipClass, SchemaItemKey, SchemaItemType, StructClass, StructPropertyProps } from \"@itwin/ecschema-metadata\";\nimport { getClassEditor, toItemKey, toPropertyKey, updateSchemaItemFullName, updateSchemaItemKey } from \"./Utils\";\nimport { MutableProperty } from \"../Editing/Mutable/MutableProperty\";\nimport { applyCustomAttributes } from \"./CustomAttributeMerger\";\n\ntype PartialEditable<T> = {\n  -readonly [P in keyof T]: T[P];\n};\n\ninterface PropertyMerger<T extends AnyPropertyProps> {\n  is(property: AnyPropertyProps): property is T;\n  add(context: SchemaMergeContext, itemKey: SchemaItemKey, props: PartialEditable<T>): Promise<void>;\n  merge(context: SchemaMergeContext, itemKey: SchemaItemKey, property: AnyProperty, props: T): Promise<void>;\n}\n\n/**\n * @internal\n */\nexport async function mergePropertyDifference(context: SchemaMergeContext, change: ClassPropertyDifference): Promise<void> {\n  const classKey = new SchemaItemKey(change.itemName, context.targetSchemaKey);\n  return mergeClassProperty(context, change, classKey, {\n    ...change.difference,\n    name: change.path,\n  } as AnyPropertyProps);\n}\n\n/**\n * @internal\n */\nexport async function mergeClassProperties(context: SchemaMergeContext, change: AnyClassItemDifference, itemKey: SchemaItemKey): Promise<void> {\n  for (const property of change.difference.properties || []) {\n    await mergeClassProperty(context, change, itemKey, property);\n  }\n}\n\nasync function mergeClassProperty(context: SchemaMergeContext, change: { changeType: DifferenceType }, itemKey: SchemaItemKey, property: AnyPropertyProps) {\n  return change.changeType === \"add\"\n    ? addClassProperty(context, itemKey, property)\n    : modifyClassProperty(context, itemKey, property);\n}\n\nasync function addClassProperty(context: SchemaMergeContext, itemKey: SchemaItemKey, property: PartialEditable<AnyPropertyProps>): Promise<void> {\n  const ecClass = await context.targetSchema.lookupItem(toItemKey(context, itemKey.name)) as ECClass;\n\n  if (property.category !== undefined) {\n    property.category = await updateSchemaItemFullName(context, property.category);\n  }\n\n  if (property.kindOfQuantity !== undefined) {\n    property.kindOfQuantity = await updateSchemaItemFullName(context, property.kindOfQuantity);\n  }\n\n  await createProperty(context, ecClass.key, property);\n\n  if (property.customAttributes !== undefined) {\n    await applyCustomAttributes(context, property.customAttributes as CustomAttribute[], async (ca) => {\n      const classEditor = await getClassEditor(context, ecClass.key);\n      await classEditor.properties.addCustomAttribute(ecClass.key, property.name, ca);\n    });\n  }\n}\n\nasync function createProperty(context: SchemaMergeContext, itemKey: SchemaItemKey, property: PartialEditable<AnyPropertyProps>) {\n  if (enumerationProperty.is(property)) {\n    return enumerationProperty.add(context, itemKey, property);\n  }\n  if (navigationProperty.is(property)) {\n    return navigationProperty.add(context, itemKey, property);\n  }\n  if (primitiveProperty.is(property)) {\n    return primitiveProperty.add(context, itemKey, property);\n  }\n  if (structProperty.is(property)) {\n    return structProperty.add(context, itemKey, property);\n  }\n  return {};\n}\n\nasync function modifyClassProperty(context: SchemaMergeContext, itemKey: SchemaItemKey, propertyProps: AnyPropertyProps): Promise<void> {\n  const ecClass = await context.targetSchema.lookupItem(toItemKey(context, itemKey.name)) as ECClass;\n  const propertyKey = toPropertyKey(context, itemKey.name, propertyProps.name);\n  const property = await ecClass.getProperty(propertyKey.propertyName) as MutableProperty;\n\n  if (property === undefined) {\n    throw new Error(`Couldn't find property ${propertyKey.propertyName} on class ${ecClass.key.name}`);\n  }\n\n  if (propertyProps.type !== undefined) {\n    throw new Error(`Changing the property '${property.fullName}' type is not supported.`);\n  }\n\n  const classEditor = await getClassEditor(context, ecClass);\n\n  if (propertyProps.description !== undefined) {\n    await classEditor.properties.setDescription(ecClass.key, property.name, propertyProps.description);\n  }\n  if (propertyProps.label !== undefined) {\n    await classEditor.properties.setLabel(ecClass.key, property.name, propertyProps.label);\n  }\n  if (propertyProps.isReadOnly !== undefined) {\n    await classEditor.properties.setIsReadOnly(ecClass.key, property.name, propertyProps.isReadOnly);\n  }\n  if (propertyProps.priority !== undefined) {\n    await classEditor.properties.setPriority(ecClass.key, property.name, propertyProps.priority);\n  }\n  if (propertyProps.kindOfQuantity !== undefined) {\n    await classEditor.properties.setKindOfQuantity(ecClass.key, property.name, await updateSchemaItemKey(context, propertyProps.kindOfQuantity));\n  }\n\n  if (property.isArray()) {\n    await arrayProperty.merge(context, ecClass.key, property.name, propertyProps);\n  }\n\n  if (propertyProps.category !== undefined) {\n    const categoryKey = await updateSchemaItemKey(context, propertyProps.category);\n    await classEditor.properties.setCategory(ecClass.key, property.name, categoryKey);\n  }\n\n  if (property.isEnumeration()) {\n    return enumerationProperty.merge(context, ecClass.key, property, propertyProps as any);\n  }\n  if (property.isNavigation()) {\n    return navigationProperty.merge(context, ecClass.key, property, propertyProps as any);\n  }\n  if (property.isPrimitive()) {\n    return primitiveProperty.merge(context, ecClass.key, property, propertyProps as any);\n  }\n  if (property.isStruct()) {\n    return structProperty.merge(context, ecClass.key, property, propertyProps as any);\n  }\n}\n\nconst arrayProperty = {\n  is(property: AnyPropertyProps): boolean {\n    return \"minOccurs\" in property && \"maxOccurs\" in property;\n  },\n  async merge(context: SchemaMergeContext, itemKey: SchemaItemKey, propertyName: string, props: ArrayPropertyProps) {\n    const classEditor = await getClassEditor(context, itemKey);\n    if (props.minOccurs !== undefined) {\n      await classEditor.arrayProperties.setMinOccurs(itemKey, propertyName, props.minOccurs);\n    }\n    if (props.maxOccurs !== undefined) {\n      await classEditor.arrayProperties.setMaxOccurs(itemKey, propertyName, props.maxOccurs);\n    }\n  },\n};\n\nconst enumerationProperty: PropertyMerger<EnumerationPropertyProps> = {\n  is(property): property is EnumerationPropertyProps {\n    return primitiveProperty.is(property) && property.typeName.includes(\".\");\n  },\n  async add(context, itemKey, property): Promise<void> {\n    const enumerationKey = await updateSchemaItemKey(context, property.typeName);\n    const enumerationType = await context.editor.schemaContext.getSchemaItem(enumerationKey, Enumeration);\n    if (enumerationType === undefined) {\n      throw new Error(`Unable to locate the enumeration class ${enumerationKey.name} in the context schema.`);\n    }\n\n    property.typeName = enumerationType.fullName;\n\n    const classEditor = await getClassEditor(context, itemKey);\n\n    arrayProperty.is(property)\n      ? await classEditor.createEnumerationArrayPropertyFromProps(itemKey, property.name, enumerationType, property)\n      : await classEditor.createEnumerationPropertyFromProps(itemKey, property.name, enumerationType, property);\n  },\n  async merge(context, itemKey, property, props) {\n    if (\"enumeration\" in props && props.enumeration !== undefined) {\n      throw new Error(`Changing the property '${property.fullName}' enumeration is not supported.`);\n    }\n    return primitiveProperty.merge(context, itemKey, property, props);\n  },\n};\n\nconst navigationProperty: PropertyMerger<NavigationPropertyProps> = {\n  is(property): property is NavigationPropertyProps {\n    return property.type === \"NavigationProperty\";\n  },\n  async add(context, itemKey, property): Promise<void> {\n    const relationshipKey = await updateSchemaItemKey(context, property.relationshipName);\n    const relationshipType = await context.editor.schemaContext.getSchemaItem(relationshipKey, RelationshipClass);\n    if (relationshipType === undefined) {\n      throw new Error(`Unable to locate the relationship class ${relationshipKey.name} in the context schema.`);\n    }\n\n    property.relationshipName = relationshipType.fullName;\n\n    const ecClass = await context.editor.schemaContext.getSchemaItem(itemKey) as ECClass;\n    if (ecClass.schemaItemType === SchemaItemType.EntityClass)\n      return context.editor.entities.createNavigationPropertyFromProps(ecClass.key, property);\n    if (ecClass.schemaItemType === SchemaItemType.Mixin)\n      return context.editor.mixins.createNavigationPropertyFromProps(ecClass.key, property);\n    if (ecClass.schemaItemType === SchemaItemType.RelationshipClass)\n      return context.editor.relationships.createNavigationPropertyFromProps(ecClass.key, property);\n    throw new Error(`Navigation property can't be added to ${ecClass.schemaItemType}.`);\n  },\n  async merge(_context, _itemKey, property, props) {\n    if (props.direction !== undefined) {\n      throw new Error(`Changing the property '${property.fullName}' direction is not supported.`);\n    }\n    if (\"relationshipClass\" in props && props.relationshipClass !== undefined) {\n      throw new Error(`Changing the property '${property.fullName}' relationship class is not supported.`);\n    }\n  },\n};\n\nconst primitiveProperty: PropertyMerger<PrimitivePropertyProps> = {\n  is(property): property is PrimitivePropertyProps {\n    return property.type === \"PrimitiveProperty\" || property.type === \"PrimitiveArrayProperty\";\n  },\n  async add(context, itemKey, property): Promise<void> {\n    const propertyType = parsePrimitiveType(property.typeName);\n    if (propertyType === undefined) {\n      throw new Error(`Invalid property type ${property.typeName} on property ${property.name}`);\n    }\n\n    const classEditor = await getClassEditor(context, itemKey);\n    return arrayProperty.is(property)\n      ? classEditor.createPrimitiveArrayPropertyFromProps(itemKey, property.name, propertyType, property)\n      : classEditor.createPrimitivePropertyFromProps(itemKey, property.name, propertyType, property);\n  },\n  async merge(context, itemKey, property, props) {\n    if (props.typeName) {\n      throw new Error(`Changing the property '${property.fullName}' primitiveType is not supported.`);\n    }\n\n    const classEditor = await getClassEditor(context, itemKey);\n    if (props.extendedTypeName !== undefined) {\n      await classEditor.primitiveProperties.setExtendedTypeName(itemKey, property.name, props.extendedTypeName);\n    }\n    if (props.minLength !== undefined) {\n      await classEditor.primitiveProperties.setMinLength(itemKey, property.name, props.minLength);\n    }\n    if (props.maxLength !== undefined) {\n      await classEditor.primitiveProperties.setMaxLength(itemKey, property.name, props.maxLength);\n    }\n    if (props.minValue !== undefined) {\n      await classEditor.primitiveProperties.setMinValue(itemKey, property.name, props.minValue);\n    }\n    if (props.maxValue !== undefined) {\n      await classEditor.primitiveProperties.setMaxValue(itemKey, property.name, props.maxValue);\n    }\n  },\n};\n\nconst structProperty: PropertyMerger<StructPropertyProps> = {\n  is(property): property is StructPropertyProps {\n    return property.type === \"StructProperty\" || property.type === \"StructArrayProperty\";\n  },\n  async add(context, itemKey, property): Promise<void> {\n    const structKey = await updateSchemaItemKey(context, property.typeName);\n    const structType = await context.editor.schemaContext.getSchemaItem(structKey, StructClass);\n    if (structType === undefined) {\n      throw new Error(`Unable to locate the struct ${structKey.name} in the context schema.`);\n    }\n\n    property.typeName = structType.fullName;\n\n    const classEditor = await getClassEditor(context, itemKey);\n    return arrayProperty.is(property)\n      ? classEditor.createStructArrayPropertyFromProps(itemKey, property.name, structType, property)\n      : classEditor.createStructPropertyFromProps(itemKey, property.name, structType, property);\n  },\n  async merge(_context, _itemKey, property, props) {\n    if (\"structClass\" in props && props.structClass !== undefined) {\n      throw new Error(`Changing the property '${property.fullName}' structClass is not supported.`);\n    }\n  },\n};\n"]}

package/lib/esm/Merging/RelationshipClassMerger.d.ts

@@ -0,0 +1,27 @@
+import type { RelationshipClassDifference, RelationshipConstraintClassDifference, RelationshipConstraintDifference } from "../Differencing/SchemaDifference";
+import { SchemaMergeContext } from "./SchemaMerger";
+import { SchemaItemKey } from "@itwin/ecschema-metadata";
+/**
+ * Merges a new RelationshipClass into the target schema.
+ * @internal
+ */
+export declare function addRelationshipClass(context: SchemaMergeContext, change: RelationshipClassDifference): Promise<void>;
+/**
+ * Merges differences to an existing RelationshipClass in the target schema.
+ * @internal
+ */
+export declare function modifyRelationshipClass(context: SchemaMergeContext, change: RelationshipClassDifference, itemKey: SchemaItemKey): Promise<void>;
+/**
+ * Merges differences of a Relationship constraint.
+ * This only supports modify as the RelationshipConstraints are always set on the Relationship classes.
+ * @internal
+ */
+export declare function mergeRelationshipConstraint(context: SchemaMergeContext, change: RelationshipConstraintDifference): Promise<void | {
+    itemKey: SchemaItemKey;
+}>;
+/**
+ * Merges differences of a Relationship constraint classes.
+ * @internal
+ */
+export declare function mergeRelationshipClassConstraint(context: SchemaMergeContext, change: RelationshipConstraintClassDifference): Promise<void>;
+//# sourceMappingURL=RelationshipClassMerger.d.ts.map

package/lib/esm/Merging/RelationshipClassMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelationshipClassMerger.d.ts","sourceRoot":"","sources":["../../../src/Merging/RelationshipClassMerger.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,2BAA2B,EAAE,qCAAqC,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AAI7J,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAgJ,aAAa,EAAkB,MAAM,0BAA0B,CAAC;AAEvN;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,2BAA2B,iBAuB1G;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,2BAA2B,EAAE,OAAO,EAAE,aAAa,iBAyBrI;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,gCAAgC;;GAgCtH;AAED;;;GAGG;AACH,wBAAsB,gCAAgC,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,EAAE,qCAAqC,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhJ"}

package/lib/esm/Merging/RelationshipClassMerger.js

@@ -0,0 +1,136 @@
+import { locateSchemaItem, updateSchemaItemFullName, updateSchemaItemKey } from "./Utils";
+import { modifyClass } from "./ClassMerger";
+import { ECClass, EntityClass, Mixin, parseStrength, parseStrengthDirection, RelationshipClass, RelationshipMultiplicity, SchemaItemType } from "@itwin/ecschema-metadata";
+/**
+ * Merges a new RelationshipClass into the target schema.
+ * @internal
+ */
+export async function addRelationshipClass(context, change) {
+    if (change.difference.strength === undefined) {
+        throw new Error("RelationshipClass must define strength");
+    }
+    if (change.difference.strengthDirection === undefined) {
+        throw new Error("RelationshipClass must define strengthDirection");
+    }
+    if (change.difference.source === undefined) {
+        throw new Error("RelationshipClass must define a source constraint");
+    }
+    if (change.difference.target === undefined) {
+        throw new Error("RelationshipClass must define a target constraint");
+    }
+    await context.editor.relationships.createFromProps(context.targetSchemaKey, {
+        ...change.difference,
+        name: change.itemName,
+        schemaItemType: change.schemaType,
+        strength: change.difference.strength,
+        strengthDirection: change.difference.strengthDirection,
+        source: await updateRelationshipConstraintKey(context, change.difference.source),
+        target: await updateRelationshipConstraintKey(context, change.difference.target),
+    });
+}
+/**
+ * Merges differences to an existing RelationshipClass in the target schema.
+ * @internal
+ */
+export async function modifyRelationshipClass(context, change, itemKey) {
+    const item = await context.targetSchema.lookupItem(itemKey);
+    if (change.changeType === "modify") {
+        if (change.difference.strength !== undefined) {
+            if (item.strength === undefined) {
+                const strength = parseStrength(change.difference.strength);
+                if (strength === undefined) {
+                    throw new Error(`An invalid relationship class strength value '${change.difference.strength}' has been provided.`);
+                }
+                item.setStrength(strength);
+            }
+            throw new Error(`Changing the relationship '${itemKey.name}' strength is not supported.`);
+        }
+        if (change.difference.strengthDirection !== undefined) {
+            if (item.strengthDirection === undefined) {
+                const strengthDirection = parseStrengthDirection(change.difference.strengthDirection);
+                if (strengthDirection === undefined) {
+                    throw new Error(`An invalid relationship class strengthDirection value '${change.difference.strengthDirection}' has been provided.`);
+                }
+                item.setStrengthDirection(strengthDirection);
+            }
+            throw new Error(`Changing the relationship '${itemKey.name}' strengthDirection is not supported.`);
+        }
+    }
+    await modifyClass(context, change, itemKey, item);
+}
+/**
+ * Merges differences of a Relationship constraint.
+ * This only supports modify as the RelationshipConstraints are always set on the Relationship classes.
+ * @internal
+ */
+export async function mergeRelationshipConstraint(context, change) {
+    if (change.changeType !== "modify") {
+        throw new Error("RelationshipConstraints can only be modified.");
+    }
+    const item = await locateSchemaItem(context, change.itemName, SchemaItemType.RelationshipClass);
+    const constraint = item[parseConstraint(change.path)];
+    if (change.difference.roleLabel !== undefined) {
+        constraint.roleLabel = change.difference.roleLabel;
+    }
+    if (change.difference.polymorphic !== undefined) {
+        await context.editor.relationships.setConstraintPolymorphic(constraint, change.difference.polymorphic);
+    }
+    if (change.difference.multiplicity !== undefined) {
+        if (constraint.multiplicity === undefined) {
+            const multiplicity = RelationshipMultiplicity.fromString(change.difference.multiplicity);
+            if (multiplicity === undefined) {
+                throw new Error(`An invalid relationship constraint multiplicity value '${change.difference.multiplicity}' has been provided.`);
+            }
+            await context.editor.relationships.setConstraintMultiplicity(constraint, multiplicity);
+        }
+        throw new Error(`Changing the relationship constraint '${constraint.fullName}' multiplicity is not supported.`);
+    }
+    if (change.difference.abstractConstraint !== undefined) {
+        const itemKey = await updateSchemaItemKey(context, change.difference.abstractConstraint);
+        const abstractConstraint = await context.editor.schemaContext.getSchemaItem(itemKey, ECClass);
+        if (abstractConstraint === undefined || (!EntityClass.isEntityClass(abstractConstraint) && !Mixin.isMixin(abstractConstraint) && !RelationshipClass.isRelationshipClass(abstractConstraint))) {
+            throw new Error(`Unable to locate the abstract constraint class ${change.difference.abstractConstraint} in the context schema.`);
+        }
+        return context.editor.relationships.setAbstractConstraint(constraint, abstractConstraint);
+    }
+    return { itemKey: constraint.relationshipClass.key };
+}
+/**
+ * Merges differences of a Relationship constraint classes.
+ * @internal
+ */
+export async function mergeRelationshipClassConstraint(context, change) {
+    if (change.changeType !== "add") {
+        throw new Error(`Change type ${change.changeType} is not supported for Relationship constraint classes.`);
+    }
+    const item = await locateSchemaItem(context, change.itemName, SchemaItemType.RelationshipClass);
+    const constraint = item[parseConstraint(change.path)];
+    for (const constraintName of change.difference) {
+        const constraintClassKey = await updateSchemaItemKey(context, constraintName);
+        const constraintClass = await context.editor.schemaContext.getSchemaItem(constraintClassKey, ECClass);
+        if (constraintClass === undefined || (!EntityClass.isEntityClass(constraintClass) && !Mixin.isMixin(constraintClass) && !RelationshipClass.isRelationshipClass(constraintClass))) {
+            throw new Error(`Could not locate relationship constraint class ${constraintClassKey.name}`);
+        }
+        await context.editor.relationships.addConstraintClass(constraint, constraintClass);
+    }
+}
+function parseConstraint(path) {
+    return path.startsWith("$source")
+        ? "source"
+        : "target";
+}
+async function updateRelationshipConstraintKey(context, props) {
+    let abstractConstraint = props.abstractConstraint;
+    if (abstractConstraint !== undefined)
+        abstractConstraint = await updateSchemaItemFullName(context, abstractConstraint);
+    const constraintClasses = [];
+    for (const ecClass of props.constraintClasses) {
+        constraintClasses.push(await updateSchemaItemFullName(context, ecClass));
+    }
+    return {
+        ...props,
+        abstractConstraint,
+        constraintClasses,
+    };
+}
+//# sourceMappingURL=RelationshipClassMerger.js.map

package/lib/esm/Merging/RelationshipClassMerger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RelationshipClassMerger.js","sourceRoot":"","sources":["../../../src/Merging/RelationshipClassMerger.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*--------------------------------------------------------------------------------------------*/\nimport type { RelationshipClassDifference, RelationshipConstraintClassDifference, RelationshipConstraintDifference } from \"../Differencing/SchemaDifference\";\nimport type { MutableRelationshipClass } from \"../Editing/Mutable/MutableRelationshipClass\";\nimport { locateSchemaItem, updateSchemaItemFullName, updateSchemaItemKey } from \"./Utils\";\nimport { modifyClass } from \"./ClassMerger\";\nimport { SchemaMergeContext } from \"./SchemaMerger\";\nimport { ECClass, EntityClass, Mixin, parseStrength, parseStrengthDirection, RelationshipClass, RelationshipConstraintProps, RelationshipMultiplicity, SchemaItemKey, SchemaItemType } from \"@itwin/ecschema-metadata\";\n\n/**\n * Merges a new RelationshipClass into the target schema.\n * @internal\n */\nexport async function addRelationshipClass(context: SchemaMergeContext, change: RelationshipClassDifference) {\n  if (change.difference.strength === undefined) {\n    throw new Error(\"RelationshipClass must define strength\");\n  }\n  if (change.difference.strengthDirection === undefined) {\n    throw new Error(\"RelationshipClass must define strengthDirection\");\n  }\n  if (change.difference.source === undefined) {\n    throw new Error(\"RelationshipClass must define a source constraint\");\n  }\n  if (change.difference.target === undefined) {\n    throw new Error(\"RelationshipClass must define a target constraint\");\n  }\n\n  await context.editor.relationships.createFromProps(context.targetSchemaKey, {\n    ...change.difference,\n    name: change.itemName,\n    schemaItemType: change.schemaType,\n    strength: change.difference.strength,\n    strengthDirection: change.difference.strengthDirection,\n    source: await updateRelationshipConstraintKey(context, change.difference.source),\n    target: await updateRelationshipConstraintKey(context, change.difference.target),\n  });\n}\n\n/**\n * Merges differences to an existing RelationshipClass in the target schema.\n * @internal\n */\nexport async function modifyRelationshipClass(context: SchemaMergeContext, change: RelationshipClassDifference, itemKey: SchemaItemKey) {\n  const item = await context.targetSchema.lookupItem(itemKey) as MutableRelationshipClass;\n  if(change.changeType === \"modify\") {\n    if(change.difference.strength !== undefined) {\n      if (item.strength === undefined) {\n        const strength = parseStrength(change.difference.strength);\n        if (strength === undefined) {\n          throw new Error(`An invalid relationship class strength value '${change.difference.strength}' has been provided.`);\n        }\n        item.setStrength(strength);\n      }\n      throw new Error(`Changing the relationship '${itemKey.name}' strength is not supported.`);\n    }\n    if(change.difference.strengthDirection !== undefined) {\n      if (item.strengthDirection === undefined) {\n        const strengthDirection = parseStrengthDirection(change.difference.strengthDirection);\n        if (strengthDirection === undefined) {\n          throw new Error(`An invalid relationship class strengthDirection value '${change.difference.strengthDirection}' has been provided.`);\n        }\n        item.setStrengthDirection(strengthDirection);\n      }\n      throw new Error(`Changing the relationship '${itemKey.name}' strengthDirection is not supported.`);\n    }\n  }\n  await modifyClass(context, change, itemKey, item);\n}\n\n/**\n * Merges differences of a Relationship constraint.\n * This only supports modify as the RelationshipConstraints are always set on the Relationship classes.\n * @internal\n */\nexport async function mergeRelationshipConstraint(context: SchemaMergeContext, change: RelationshipConstraintDifference) {\n  if(change.changeType !== \"modify\") {\n    throw new Error(\"RelationshipConstraints can only be modified.\");\n  }\n\n  const item = await locateSchemaItem(context, change.itemName, SchemaItemType.RelationshipClass) as MutableRelationshipClass;\n  const constraint = item[parseConstraint(change.path)];\n  if(change.difference.roleLabel !== undefined) {\n    constraint.roleLabel = change.difference.roleLabel;\n  }\n  if(change.difference.polymorphic !== undefined) {\n    await context.editor.relationships.setConstraintPolymorphic(constraint, change.difference.polymorphic);\n  }\n  if(change.difference.multiplicity !== undefined) {\n    if (constraint.multiplicity === undefined) {\n      const multiplicity = RelationshipMultiplicity.fromString(change.difference.multiplicity);\n      if (multiplicity === undefined) {\n        throw new Error(`An invalid relationship constraint multiplicity value '${change.difference.multiplicity}' has been provided.`);\n      }\n      await context.editor.relationships.setConstraintMultiplicity(constraint, multiplicity);\n    }\n    throw new Error(`Changing the relationship constraint '${constraint.fullName}' multiplicity is not supported.`);\n  }\n  if(change.difference.abstractConstraint !== undefined) {\n    const itemKey = await updateSchemaItemKey(context, change.difference.abstractConstraint);\n    const abstractConstraint = await context.editor.schemaContext.getSchemaItem(itemKey, ECClass);\n    if (abstractConstraint === undefined || (!EntityClass.isEntityClass(abstractConstraint) && !Mixin.isMixin(abstractConstraint) && !RelationshipClass.isRelationshipClass(abstractConstraint))) {\n      throw new Error(`Unable to locate the abstract constraint class ${change.difference.abstractConstraint} in the context schema.`);\n    }\n    return context.editor.relationships.setAbstractConstraint(constraint, abstractConstraint);\n  }\n  return { itemKey: constraint.relationshipClass.key };\n}\n\n/**\n * Merges differences of a Relationship constraint classes.\n * @internal\n */\nexport async function mergeRelationshipClassConstraint(context: SchemaMergeContext, change: RelationshipConstraintClassDifference): Promise<void> {\n  if(change.changeType !== \"add\") {\n    throw new Error(`Change type ${change.changeType} is not supported for Relationship constraint classes.`);\n  }\n\n  const item = await locateSchemaItem(context, change.itemName, SchemaItemType.RelationshipClass) as MutableRelationshipClass;\n  const constraint = item[parseConstraint(change.path)];\n  for(const constraintName of change.difference) {\n    const constraintClassKey = await updateSchemaItemKey(context, constraintName);\n    const constraintClass = await context.editor.schemaContext.getSchemaItem(constraintClassKey, ECClass);\n    if(constraintClass === undefined || (!EntityClass.isEntityClass(constraintClass) && !Mixin.isMixin(constraintClass) && !RelationshipClass.isRelationshipClass(constraintClass))) {\n      throw new Error(`Could not locate relationship constraint class ${constraintClassKey.name}`);\n    }\n\n    await context.editor.relationships.addConstraintClass(constraint, constraintClass);\n  }\n}\n\nfunction parseConstraint(path: string): \"source\" | \"target\" {\n  return path.startsWith(\"$source\")\n    ? \"source\"\n    : \"target\";\n}\n\nasync function updateRelationshipConstraintKey(context: SchemaMergeContext, props: RelationshipConstraintProps): Promise<RelationshipConstraintProps> {\n  let abstractConstraint = props.abstractConstraint;\n  if (abstractConstraint !== undefined)\n    abstractConstraint = await updateSchemaItemFullName(context, abstractConstraint);\n\n  const constraintClasses: string[] = [];\n  for (const ecClass of props.constraintClasses) {\n    constraintClasses.push(await updateSchemaItemFullName(context, ecClass));\n  }\n\n  return {\n    ...props,\n    abstractConstraint,\n    constraintClasses,\n  };\n}\n"]}

package/lib/esm/Merging/SchemaMerger.d.ts

@@ -0,0 +1,49 @@
+/** @packageDocumentation
+ * @module Merging
+ */
+import { Schema, SchemaContext, SchemaKey } from "@itwin/ecschema-metadata";
+import { SchemaContextEditor } from "../Editing/Editor";
+import { type SchemaDifferenceResult } from "../Differencing/SchemaDifference";
+import { SchemaEdits } from "./Edits/SchemaEdits";
+import { NameMapping } from "./Edits/NameMapping";
+/**
+ * Defines the context of a Schema merging run.
+ * @internal
+ */
+export interface SchemaMergeContext {
+    readonly targetSchema: Schema;
+    readonly targetSchemaKey: SchemaKey;
+    readonly sourceSchemaKey: SchemaKey;
+    readonly editor: SchemaContextEditor;
+    readonly nameMapping: NameMapping;
+}
+/**
+ * Class to merge two schemas together.
+ * @see [[merge]] or [[mergeSchemas]] to merge two schemas together.
+ * @beta
+ */
+export declare class SchemaMerger {
+    private readonly _editingContext;
+    /**
+     * Constructs a new instance of the SchemaMerger object.
+     * @param editingContext  The schema contexts that holds the schema to be edited.
+     */
+    constructor(editingContext: SchemaContext);
+    /**
+     * Copy the SchemaItems of the source schemas to the target schema.
+     * @param targetSchema  The schema the SchemaItems gets merged to.
+     * @param sourceSchema  The schema the SchemaItems gets copied from.
+     * @param edits         An optional instance of schema edits that shall be applied before the schemas get merged.
+     * @returns             The merged target schema.
+     * @alpha
+     */
+    mergeSchemas(targetSchema: Schema, sourceSchema: Schema, edits?: SchemaEdits): Promise<Schema>;
+    /**
+     * Merges the schema differences into the target schema context.
+     * @param differenceResult  The differences that shall be applied to the target schema.
+     * @param edits             An optional instance of schema edits that shall be applied before the schemas get merged.
+     * @alpha
+     */
+    merge(differenceResult: SchemaDifferenceResult, edits?: SchemaEdits): Promise<Schema>;
+}
+//# sourceMappingURL=SchemaMerger.d.ts.map

package/lib/esm/Merging/SchemaMerger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaMerger.d.ts","sourceRoot":"","sources":["../../../src/Merging/SchemaMerger.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAA6B,SAAS,EAAmB,MAAM,0BAA0B,CAAC;AACxH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EAAwB,KAAK,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAGrG,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED;;;;GAIG;AACH,qBAAa,YAAY;IAEvB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAgB;IAEhD;;;OAGG;gBACS,cAAc,EAAE,aAAa;IAIzC;;;;;;;OAOG;IACU,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;IAI3G;;;;;OAKG;IACU,KAAK,CAAC,gBAAgB,EAAE,sBAAsB,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CA+CnG"}