@finos/legend-graph 1.2.1 → 1.3.0

package/src/models/protocols/pure/v1/transformation/pureGraph/from/V1_MappingTransformer.ts

@@ -15,6 +15,7 @@
  */
 
 import {
+  guaranteeNonEmptyString,
   IllegalStateError,
   isNonNullable,
   recursiveOmit,
@@ -146,6 +147,9 @@ import { toJS } from 'mobx';
 import type { DSLMapping_PureProtocolProcessorPlugin_Extension } from '../../../../DSLMapping_PureProtocolProcessorPlugin_Extension';
 import type { InstanceSetImplementation } from '../../../../../../metamodels/pure/packageableElements/mapping/InstanceSetImplementation';
 import type { SubstituteStore } from '../../../../../../metamodels/pure/packageableElements/mapping/SubstituteStore';
+import { V1_BindingTransformer } from '../../../model/packageableElements/externalFormat/store/V1_BindingTransformer';
+import { V1_MergeOperationClassMapping } from '../../../model/packageableElements/mapping/V1_MergeOperationClassMapping';
+import { MergeOperationSetImplementation } from '../../../../../../metamodels/pure/packageableElements/mapping/MergeOperationSetImplementation';
 
 export const V1_transformPropertyReference = (
   element: PropertyReference,
@@ -488,6 +492,13 @@ const transformRelationalPropertyMapping = (
   propertyMapping.target = transformPropertyMappingTarget(
     element.targetSetImplementation,
   );
+  if (element.bindingTransformer?.binding) {
+    const bindingTransformer = new V1_BindingTransformer();
+    bindingTransformer.binding = guaranteeNonEmptyString(
+      element.bindingTransformer.binding.valueForSerialization,
+    );
+    propertyMapping.bindingTransformer = bindingTransformer;
+  }
   if (element.localMappingProperty) {
     propertyMapping.localMappingProperty = transformLocalPropertyInfo(
       element.localMappingProperty,
@@ -744,6 +755,8 @@ const transformOperationType = (
       return V1_MappingOperationType.STORE_UNION;
     case OperationType.INHERITANCE:
       return V1_MappingOperationType.INHERITANCE;
+    case OperationType.MERGE:
+      return V1_MappingOperationType.MERGE;
     default:
       throw new UnsupportedOperationError(
         `Can't transform operation type`,
@@ -769,6 +782,28 @@ const transformOperationSetImplementation = (
   return classMapping;
 };
 
+const transformMergeOperationSetImplementation = (
+  element: MergeOperationSetImplementation,
+  context: V1_GraphTransformerContext,
+): V1_MergeOperationClassMapping => {
+  const classMapping = new V1_MergeOperationClassMapping();
+  classMapping.class = V1_transformElementReference(element.class);
+  classMapping.id = mappingElementIdSerializer(element.id);
+  classMapping.operation = transformOperationType(element.operation);
+  classMapping.validationFunction =
+    element.validationFunction.accept_RawValueSpecificationVisitor(
+      new V1_RawValueSpecificationTransformer(context),
+    ) as V1_RawLambda;
+  classMapping.parameters = element.parameters.map(
+    (e) => e.setImplementation.value.id.value,
+  );
+  const root = transformMappingElementRoot(element.root);
+  if (root !== undefined) {
+    classMapping.root = root;
+  }
+  return classMapping;
+};
+
 const transformPureInstanceSetImplementation = (
   element: PureInstanceSetImplementation,
   context: V1_GraphTransformerContext,
@@ -1042,8 +1077,25 @@ export class V1_SetImplementationTransformer
   visit_OperationSetImplementation(
     setImplementation: OperationSetImplementation,
   ): V1_ClassMapping | undefined {
-    return transformOperationSetImplementation(setImplementation);
+    if (setImplementation instanceof MergeOperationSetImplementation) {
+      return transformMergeOperationSetImplementation(
+        setImplementation,
+        this.context,
+      );
+    } else {
+      return transformOperationSetImplementation(setImplementation);
+    }
   }
+
+  visit_MergeOperationSetImplementation(
+    setImplementation: MergeOperationSetImplementation,
+  ): V1_ClassMapping | undefined {
+    return transformMergeOperationSetImplementation(
+      setImplementation,
+      this.context,
+    );
+  }
+
   visit_PureInstanceSetImplementation(
     setImplementation: PureInstanceSetImplementation,
   ): V1_ClassMapping | undefined {

package/src/models/protocols/pure/v1/transformation/pureGraph/to/V1_DSLExternalFormat_GraphBuilderHelper.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {
+  getSchemaSet,
+  getBinding,
+} from '../../../../../../../graphManager/DSLExternalFormat_GraphManagerHelper';
+import type { PackageableElementImplicitReference } from '../../../../../../metamodels/pure/packageableElements/PackageableElementReference';
+import type { SchemaSet } from '../../../../../../metamodels/pure/packageableElements/externalFormat/schemaSet/DSLExternalFormat_SchemaSet';
+import type { Binding } from '../../../../../../metamodels/pure/packageableElements/externalFormat/store/DSLExternalFormat_Binding';
+import type { V1_GraphBuilderContext } from './V1_GraphBuilderContext';
+
+export const V1_resolveSchemaSet = (
+  path: string,
+  context: V1_GraphBuilderContext,
+): PackageableElementImplicitReference<SchemaSet> =>
+  context.createImplicitPackageableElementReference(path, (_path: string) =>
+    getSchemaSet(_path, context.graph),
+  );
+
+export const V1_resolveBinding = (
+  path: string,
+  context: V1_GraphBuilderContext,
+): PackageableElementImplicitReference<Binding> =>
+  context.createImplicitPackageableElementReference(path, (_path: string) =>
+    getBinding(_path, context.graph),
+  );

package/src/models/protocols/pure/v1/transformation/pureGraph/to/V1_ProtocolToMetaModelClassMappingFirstPassBuilder.ts

@@ -48,6 +48,8 @@ import { V1_resolvePathsInRawLambda } from './helpers/V1_ValueSpecificationPathR
 import { V1_buildRelationalMappingFilter } from './helpers/V1_RelationalClassMappingBuilderHelper';
 import { toOptionalPackageableElementReference } from '../../../../../../metamodels/pure/packageableElements/PackageableElementReference';
 import type { DSLMapping_PureProtocolProcessorPlugin_Extension } from '../../../../DSLMapping_PureProtocolProcessorPlugin_Extension';
+import type { V1_MergeOperationClassMapping } from '../../../model/packageableElements/mapping/V1_MergeOperationClassMapping';
+import { MergeOperationSetImplementation } from '../../../../../../metamodels/pure/packageableElements/mapping/MergeOperationSetImplementation';
 
 export class V1_ProtocolToMetaModelClassMappingFirstPassBuilder
   implements V1_ClassMappingVisitor<SetImplementation>
@@ -108,6 +110,36 @@ export class V1_ProtocolToMetaModelClassMappingFirstPassBuilder
     );
   }
 
+  visit_MergeOperationClassMapping(
+    classMapping: V1_MergeOperationClassMapping,
+  ): SetImplementation {
+    assertNonEmptyString(
+      classMapping.class,
+      `Merge Operation class mapping 'class' field is missing or empty`,
+    );
+    assertNonNullable(
+      classMapping.root,
+      `Merge Operation class mapping 'root' field is missing`,
+    );
+    assertNonNullable(
+      classMapping.operation,
+      `Merge Operation class mapping operation is missing`,
+    );
+    const targetClass = this.context.resolveClass(classMapping.class);
+    return new MergeOperationSetImplementation(
+      V1_getInferredClassMappingId(targetClass.value, classMapping),
+      this.parent,
+      targetClass,
+      InferableMappingElementRootExplicitValue.create(classMapping.root),
+      getClassMappingOperationType(classMapping.operation),
+      V1_resolvePathsInRawLambda(
+        this.context,
+        classMapping.validationFunction.parameters,
+        classMapping.validationFunction.body,
+      ),
+    );
+  }
+
   visit_PureInstanceClassMapping(
     classMapping: V1_PureInstanceClassMapping,
   ): SetImplementation {

package/src/models/protocols/pure/v1/transformation/pureGraph/to/V1_ProtocolToMetaModelClassMappingSecondPassBuilder.ts

@@ -66,6 +66,7 @@ import {
   getOwnClassMappingById,
 } from '../../../../../../../helpers/MappingHelper';
 import type { DSLMapping_PureProtocolProcessorPlugin_Extension } from '../../../../DSLMapping_PureProtocolProcessorPlugin_Extension';
+import type { V1_MergeOperationClassMapping } from '../../../model/packageableElements/mapping/V1_MergeOperationClassMapping';
 
 export class V1_ProtocolToMetaModelClassMappingSecondPassBuilder
   implements V1_ClassMappingVisitor<void>
@@ -128,6 +129,12 @@ export class V1_ProtocolToMetaModelClassMappingSecondPassBuilder
       .filter(isNonNullable);
   }
 
+  visit_MergeOperationClassMapping(
+    classMapping: V1_MergeOperationClassMapping,
+  ): void {
+    this.visit_OperationClassMapping(classMapping);
+  }
+
   visit_PureInstanceClassMapping(
     classMapping: V1_PureInstanceClassMapping,
   ): void {

package/src/models/protocols/pure/v1/transformation/pureGraph/to/V1_ProtocolToMetaModelPropertyMappingBuilder.ts

@@ -89,7 +89,9 @@ import {
 } from '../../../../../../../helpers/MappingHelper';
 import { GraphBuilderError } from '../../../../../../../graphManager/GraphManagerUtils';
 import type { AbstractProperty } from '../../../../../../metamodels/pure/packageableElements/domain/AbstractProperty';
+import { BindingTransformer } from '../../../../../../metamodels/pure/packageableElements/externalFormat/store/BindingTransformer';
 import type { Mapping } from '../../../../../../metamodels/pure/packageableElements/mapping/Mapping';
+import { V1_resolveBinding } from './V1_DSLExternalFormat_GraphBuilderHelper';
 
 /* @MARKER: RELAXED GRAPH CHECK - See https://github.com/finos/legend-studio/issues/880 */
 const TEMPORARY__getClassMappingByIdOrReturnUnresolved = (
@@ -533,6 +535,15 @@ export class V1_ProtocolToMetaModelPropertyMappingBuilder
       sourceSetImplementation,
       targetSetImplementation,
     );
+    if (protocol.bindingTransformer?.binding) {
+      const bindingTransformer = new BindingTransformer();
+      const binding = V1_resolveBinding(
+        protocol.bindingTransformer.binding,
+        this.context,
+      );
+      bindingTransformer.binding = binding;
+      relationalPropertyMapping.bindingTransformer = bindingTransformer;
+    }
     // NOTE: we only need to use the raw form of the operation for the editor
     // but we need to process it anyway so we can:
     // 1. do analytics on table alias map

package/src/models/protocols/pure/v1/transformation/pureGraph/to/helpers/V1_DatabaseBuilderHelper.ts

@@ -70,6 +70,7 @@ import {
   TinyInt,
   SmallInt,
   BigInt,
+  SemiStructured,
 } from '../../../../../../../metamodels/pure/packageableElements/store/relational/model/RelationalDataType';
 import { ColumnMapping } from '../../../../../../../metamodels/pure/packageableElements/store/relational/model/ColumnMapping';
 import { GroupByMapping } from '../../../../../../../metamodels/pure/packageableElements/store/relational/mapping/GroupByMapping';
@@ -103,6 +104,7 @@ import {
   V1_VarBinary,
   V1_Binary,
   V1_Other,
+  V1_SemiStructured,
 } from '../../../../model/packageableElements/store/relational/model/V1_RelationalDataType';
 import type { V1_View } from '../../../../model/packageableElements/store/relational/model/V1_View';
 import type { V1_Join } from '../../../../model/packageableElements/store/relational/model/V1_Join';
@@ -405,6 +407,8 @@ export const V1_transformDatabaseDataType = (
     return new Timestamp();
   } else if (dataType instanceof V1_Other) {
     return new Other();
+  } else if (dataType instanceof V1_SemiStructured) {
+    return new SemiStructured();
   }
   throw new UnsupportedOperationError(
     `Can't transform relational data type`,

package/src/models/protocols/pure/v1/transformation/pureGraph/to/helpers/V1_RelationalConnectionBuilderHelper.ts

@@ -183,17 +183,30 @@ export const V1_buildDatasourceSpecification = (
       `Redshift datasource specification 'databaseName' field is missing or empty`,
     );
     assertNonEmptyString(
-      protocol.endpoint,
-      `Redshift datasource specification 'endpoint' field is missing or empty`,
+      protocol.host,
+      `Redshift datasource specification 'host' field is missing or empty`,
     );
-    assertNonNullable(
-      protocol.port,
+    assertNonEmptyString(
+      protocol.port.toString(),
       `Redshift datasource specification 'port' field is missing or empty`,
     );
+    assertNonEmptyString(
+      protocol.clusterID,
+      `Redshift datasource specification 'clusterID' field is missing or empty`,
+    );
+
+    assertNonEmptyString(
+      protocol.region,
+      `Redshift datasource specification 'region' field is missing or empty`,
+    );
+
     const redshiftSpec = new RedshiftDatasourceSpecification(
       protocol.databaseName,
-      protocol.endpoint,
+      protocol.endpointURL,
       protocol.port,
+      protocol.host,
+      protocol.clusterID,
+      protocol.region,
     );
     return redshiftSpec;
   }

package/src/models/protocols/pure/v1/transformation/pureGraph/to/helpers/V1_ValueSpecificationBuilderHelper.ts

@@ -866,8 +866,7 @@ export function V1_processProperty(
   } else {
     inferredVariable = processedParameters[0];
   }
-  let inferredType: Type | undefined =
-    inferredVariable?.genericType?.value.rawType;
+  let inferredType = inferredVariable?.genericType?.value.rawType;
   if (inferredVariable instanceof AbstractPropertyExpression) {
     inferredType = inferredVariable.func.genericType.value.rawType;
   } else {

package/src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_ConnectionSerializationHelper.ts

@@ -199,9 +199,12 @@ const redshiftDatasourceSpecificationModelSchema = createModelSchema(
   V1_RedshiftDatasourceSpecification,
   {
     _type: usingConstantValueSchema(V1_DatasourceSpecificationType.REDSHIFT),
+    clusterID: primitive(),
     databaseName: primitive(),
-    endpoint: primitive(),
+    endpointURL: optional(primitive()),
+    host: primitive(),
     port: primitive(),
+    region: primitive(),
   },
 );
 

package/src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_DSLExternalFormat_ProtocolHelper.ts

@@ -0,0 +1,90 @@
+/**
+ * Copyright (c) 2020-present, Goldman Sachs
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import {
+  usingConstantValueSchema,
+  usingModelSchema,
+} from '@finos/legend-shared';
+import {
+  alias,
+  createModelSchema,
+  primitive,
+  list,
+  optional,
+  custom,
+  serialize,
+  deserialize,
+} from 'serializr';
+import { V1_ExternalFormatConnection } from '../../../model/packageableElements/externalFormat/connection/V1_DSLExternalFormat_ExternalFormatConnection';
+import { V1_UrlStream } from '../../../model/packageableElements/externalFormat/connection/V1_DSLExternalFormat_UrlStream';
+import { V1_Schema } from '../../../model/packageableElements/externalFormat/schemaSet/V1_DSLExternalFormat_Schema';
+import { V1_SchemaSet } from '../../../model/packageableElements/externalFormat/schemaSet/V1_DSLExternalFormat_SchemaSet';
+import { V1_Binding } from '../../../model/packageableElements/externalFormat/store/V1_DSLExternalFormat_Binding';
+import { V1_ModelUnit } from '../../../model/packageableElements/externalFormat/store/V1_DSLExternalFormat_ModelUnit';
+
+export const V1_SCHEMA_SET_ELEMENT_PROTOCOL_TYPE = 'externalFormatSchemaSet';
+export const V1_BINDING_ELEMENT_PROTOCOL_TYPE = 'binding';
+export const V1_EXTERNAL_FORMAT_CONNECTION_ELEMENT_PROTOCOL_TYPE =
+  'ExternalFormatConnection';
+
+const V1_schemaModelSchema = createModelSchema(V1_Schema, {
+  content: primitive(),
+  id: optional(primitive()),
+  location: optional(primitive()),
+});
+
+export const V1_schemaSetModelSchema = createModelSchema(V1_SchemaSet, {
+  _type: usingConstantValueSchema(V1_SCHEMA_SET_ELEMENT_PROTOCOL_TYPE),
+  format: primitive(),
+  name: primitive(),
+  package: primitive(),
+  schemas: list(usingModelSchema(V1_schemaModelSchema)),
+});
+
+const V1_modelUnitModelSchema = createModelSchema(V1_ModelUnit, {
+  packageableElementExcludes: list(primitive()),
+  packageableElementIncludes: list(primitive()),
+});
+
+export const V1_bindingModelSchema = createModelSchema(V1_Binding, {
+  _type: usingConstantValueSchema(V1_BINDING_ELEMENT_PROTOCOL_TYPE),
+  contentType: primitive(),
+  includedStores: list(primitive()),
+  modelUnit: custom(
+    (val) => serialize(V1_modelUnitModelSchema, val),
+    (val) => deserialize(V1_modelUnitModelSchema, val),
+  ),
+  name: primitive(),
+  package: primitive(),
+  schemaId: optional(primitive()),
+  schemaSet: primitive(),
+});
+
+const V1_urlStreamModelSchema = createModelSchema(V1_UrlStream, {
+  _type: usingConstantValueSchema('urlStream'),
+  url: primitive(),
+});
+
+export const V1_externalFormatConnectionModelSchema = createModelSchema(
+  V1_ExternalFormatConnection,
+  {
+    _type: usingConstantValueSchema(
+      V1_EXTERNAL_FORMAT_CONNECTION_ELEMENT_PROTOCOL_TYPE,
+    ),
+    store: alias('element', optional(primitive())),
+    externalSource: usingModelSchema(V1_urlStreamModelSchema),
+  },
+);

package/src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_DatabaseSerializationHelper.ts

@@ -60,6 +60,7 @@ import {
   V1_Timestamp,
   V1_Other,
   V1_Decimal,
+  V1_SemiStructured,
 } from '../../../model/packageableElements/store/relational/model/V1_RelationalDataType';
 import { V1_View } from '../../../model/packageableElements/store/relational/model/V1_View';
 import { V1_FilterPointer } from '../../../model/packageableElements/store/relational/mapping/V1_FilterPointer';
@@ -130,6 +131,7 @@ enum V1_RelationalDataTypeType {
   TIMESTAMP = 'Timestamp',
   ARRAY = 'Array',
   OTHER = 'Other',
+  SEMISTRUCTURED = 'SemiStructured',
 }
 
 const V1_otherRelationalDataTypeModelSchema = createModelSchema(V1_Other, {
@@ -208,6 +210,13 @@ const V1_varCharRelationalDataTypeModelSchema = createModelSchema(V1_VarChar, {
   size: primitive(),
 });
 
+const V1_semiStructuredRelationalDataTypeModelSchema = createModelSchema(
+  V1_SemiStructured,
+  {
+    _type: usingConstantValueSchema(V1_RelationalDataTypeType.SEMISTRUCTURED),
+  },
+);
+
 const V1_serializeColType = (
   protocol: V1_RelationalDataType,
 ): PlainObject<V1_RelationalDataType> => {
@@ -245,6 +254,8 @@ const V1_serializeColType = (
     return serialize(V1_decimalRelationalDataTypeModelSchema, protocol);
   } else if (protocol instanceof V1_Other) {
     return serialize(V1_otherRelationalDataTypeModelSchema, protocol);
+  } else if (protocol instanceof V1_SemiStructured) {
+    return serialize(V1_semiStructuredRelationalDataTypeModelSchema, protocol);
   }
   throw new UnsupportedOperationError(
     `Can't serialize relational data type`,
@@ -292,6 +303,8 @@ const V1_deserializeColType = (
       return deserialize(V1_decimalRelationalDataTypeModelSchema, json);
     case V1_RelationalDataTypeType.OTHER:
       return deserialize(V1_otherRelationalDataTypeModelSchema, json);
+    case V1_RelationalDataTypeType.SEMISTRUCTURED:
+      return deserialize(V1_semiStructuredRelationalDataTypeModelSchema, json);
     default:
       throw new UnsupportedOperationError(
         `Can't deserialize relational column data type '${json._type}'`,

package/src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_MappingSerializationHelper.ts

@@ -39,6 +39,7 @@ import {
   UnsupportedOperationError,
   serializeArray,
   usingModelSchema,
+  optionalCustom,
 } from '@finos/legend-shared';
 import { PRIMITIVE_TYPE } from '../../../../../../../MetaModelConst';
 import type { V1_InputData } from '../../../model/packageableElements/mapping/V1_InputData';
@@ -98,9 +99,12 @@ import { V1_XStoreAssociationMapping } from '../../../model/packageableElements/
 import { V1_RelationalInputData } from '../../../model/packageableElements/store/relational/mapping/V1_RelationalInputData';
 import type { DSLMapping_PureProtocolProcessorPlugin_Extension } from '../../../../DSLMapping_PureProtocolProcessorPlugin_Extension';
 import type { PureProtocolProcessorPlugin } from '../../../../PureProtocolProcessorPlugin';
+import { V1_BindingTransformer } from '../../../model/packageableElements/externalFormat/store/V1_BindingTransformer';
+import { V1_MergeOperationClassMapping } from '../../../model/packageableElements/mapping/V1_MergeOperationClassMapping';
 
 enum V1_ClassMappingType {
   OPERATION = 'operation',
+  MERGE_OPERATION = 'mergeOperation',
   PUREINSTANCE = 'pureInstance',
   ROOT_FLAT_DATA = 'flatData',
   ROOT_RELATIONAL = 'relational',
@@ -160,6 +164,19 @@ const operationClassMappingModelSchema = createModelSchema(
   },
 );
 
+const mergeOperationClassMappingModelSchema = createModelSchema(
+  V1_MergeOperationClassMapping,
+  {
+    _type: usingConstantValueSchema(V1_ClassMappingType.MERGE_OPERATION),
+    class: primitive(),
+    id: optional(primitive()),
+    operation: primitive(),
+    parameters: list(primitive()),
+    root: primitive(),
+    validationFunction: usingModelSchema(V1_rawLambdaModelSchema),
+  },
+);
+
 function V1_serializeM2MPropertyMapping(
   protocol: V1_PurePropertyMapping,
 ): PlainObject<V1_PurePropertyMapping> | typeof SKIP {
@@ -265,10 +282,18 @@ const relationalClassMappingModelSchema = createModelSchema(
   },
 );
 
+const bindingTransformerModelSchema = createModelSchema(V1_BindingTransformer, {
+  binding: primitive(),
+});
+
 const relationalPropertyMappingModelSchema = createModelSchema(
   V1_RelationalPropertyMapping,
   {
     _type: usingConstantValueSchema(V1_PropertyMappingType.RELATIONAL),
+    bindingTransformer: optionalCustom(
+      (val) => serialize(bindingTransformerModelSchema, val),
+      (val) => deserialize(bindingTransformerModelSchema, val),
+    ),
     enumMappingId: optional(primitive()),
     localMappingProperty: usingModelSchema(
       V1_localMappingPropertyInfoModelSchema,
@@ -564,7 +589,9 @@ function V1_serializeClassMapping(
   value: V1_ClassMapping,
   plugins?: PureProtocolProcessorPlugin[] | undefined,
 ): V1_ClassMapping {
-  if (value instanceof V1_OperationClassMapping) {
+  if (value instanceof V1_MergeOperationClassMapping) {
+    return serialize(mergeOperationClassMappingModelSchema, value);
+  } else if (value instanceof V1_OperationClassMapping) {
     return serialize(operationClassMappingModelSchema, value);
   } else if (value instanceof V1_PureInstanceClassMapping) {
     return serialize(pureInstanceClassMappingModelSchema, value);
@@ -602,6 +629,8 @@ function V1_deserializeClassMapping(
   plugins?: PureProtocolProcessorPlugin[],
 ): V1_ClassMapping {
   switch (json._type) {
+    case V1_ClassMappingType.MERGE_OPERATION:
+      return deserialize(mergeOperationClassMappingModelSchema, json);
     case V1_ClassMappingType.OPERATION:
       return deserialize(operationClassMappingModelSchema, json);
     case V1_ClassMappingType.PUREINSTANCE:

package/tsconfig.json

@@ -47,14 +47,19 @@
     "./src/StoreRelational_Exports.ts",
     "./src/index.ts",
     "./src/graph/BasicModel.ts",
+    "./src/graph/DSLExternalFormat_Extension.ts",
+    "./src/graph/DSLExternalFormat_PureGraphPlugin.ts",
     "./src/graph/DependencyManager.ts",
     "./src/graph/PureGraphExtension.ts",
     "./src/graph/PureGraphPlugin.ts",
     "./src/graph/PureModel.ts",
     "./src/graphManager/AbstractPureGraphManager.ts",
     "./src/graphManager/CorePureGraphManagerPlugin.ts",
+    "./src/graphManager/DSLExternalFormat_GraphManagerHelper.ts",
+    "./src/graphManager/DSLExternalFormat_PureGraphManagerPlugin.ts",
     "./src/graphManager/DSLGenerationSpecification_PureGraphManagerPlugin_Extension.ts",
     "./src/graphManager/DSLMapping_PureGraphManagerPlugin_Extension.ts",
+    "./src/graphManager/GraphBuilderReport.ts",
     "./src/graphManager/GraphManagerLogEvent.ts",
     "./src/graphManager/GraphManagerUtils.ts",
     "./src/graphManager/PureGraphManagerPlugin.ts",
@@ -65,6 +70,7 @@
     "./src/graphManager/action/TEMPORARY__AbstractEngineConfig.ts",
     "./src/graphManager/action/execution/ExecutionResult.ts",
     "./src/graphManager/action/execution/ExecutionResultHelper.ts",
+    "./src/graphManager/action/externalFormat/ExternalFormatDescription.ts",
     "./src/graphManager/action/generation/DatabaseBuilderInput.ts",
     "./src/graphManager/action/generation/GenerationConfigurationDescription.ts",
     "./src/graphManager/action/generation/GenerationOutput.ts",
@@ -82,6 +88,7 @@
     "./src/helpers/ServiceHelper.ts",
     "./src/helpers/Stubable.ts",
     "./src/helpers/ValidationHelper.ts",
+    "./src/models/DSLExternalFormat_ModelUtils.ts",
     "./src/models/metamodels/pure/InferableValue.ts",
     "./src/models/metamodels/pure/Reference.ts",
     "./src/models/metamodels/pure/executionPlan/ExecutionPlan.ts",
@@ -124,6 +131,13 @@
     "./src/models/metamodels/pure/packageableElements/domain/TagReference.ts",
     "./src/models/metamodels/pure/packageableElements/domain/TaggedValue.ts",
     "./src/models/metamodels/pure/packageableElements/domain/Type.ts",
+    "./src/models/metamodels/pure/packageableElements/externalFormat/connection/DSLExternalFormat_ExternalFormatConnection.ts",
+    "./src/models/metamodels/pure/packageableElements/externalFormat/connection/DSLExternalFormat_UrlStream.ts",
+    "./src/models/metamodels/pure/packageableElements/externalFormat/schemaSet/DSLExternalFormat_Schema.ts",
+    "./src/models/metamodels/pure/packageableElements/externalFormat/schemaSet/DSLExternalFormat_SchemaSet.ts",
+    "./src/models/metamodels/pure/packageableElements/externalFormat/store/BindingTransformer.ts",
+    "./src/models/metamodels/pure/packageableElements/externalFormat/store/DSLExternalFormat_Binding.ts",
+    "./src/models/metamodels/pure/packageableElements/externalFormat/store/DSLExternalFormat_ModelUnit.ts",
     "./src/models/metamodels/pure/packageableElements/fileGeneration/ConfigurationProperty.ts",
     "./src/models/metamodels/pure/packageableElements/fileGeneration/FileGenerationSpecification.ts",
     "./src/models/metamodels/pure/packageableElements/generationSpecification/AbstractGenerationSpecification.ts",
@@ -144,6 +158,7 @@
     "./src/models/metamodels/pure/packageableElements/mapping/MappingInclude.ts",
     "./src/models/metamodels/pure/packageableElements/mapping/MappingTest.ts",
     "./src/models/metamodels/pure/packageableElements/mapping/MappingTestAssert.ts",
+    "./src/models/metamodels/pure/packageableElements/mapping/MergeOperationSetImplementation.ts",
     "./src/models/metamodels/pure/packageableElements/mapping/OperationSetImplementation.ts",
     "./src/models/metamodels/pure/packageableElements/mapping/PropertyMapping.ts",
     "./src/models/metamodels/pure/packageableElements/mapping/PropertyMappingsImplementation.ts",
@@ -238,6 +253,7 @@
     "./src/models/metamodels/pure/valueSpecification/SimpleFunctionExpression.ts",
     "./src/models/metamodels/pure/valueSpecification/ValueSpecification.ts",
     "./src/models/metamodels/pure/valueSpecification/VariableExpression.ts",
+    "./src/models/protocols/pure/DSLExternalFormat_PureProtocolProcessorPlugin.ts",
     "./src/models/protocols/pure/DSLGenerationSpecification_PureProtocolProcessorPlugin_Extension.ts",
     "./src/models/protocols/pure/DSLMapping_PureProtocolProcessorPlugin_Extension.ts",
     "./src/models/protocols/pure/Pure.ts",
@@ -255,6 +271,8 @@
     "./src/models/protocols/pure/v1/engine/execution/V1_ExecuteInput.ts",
     "./src/models/protocols/pure/v1/engine/execution/V1_ExecutionError.ts",
     "./src/models/protocols/pure/v1/engine/execution/V1_ExecutionResult.ts",
+    "./src/models/protocols/pure/v1/engine/externalFormat/V1_ExternalFormatDescription.ts",
+    "./src/models/protocols/pure/v1/engine/externalFormat/V1_ExternalFormatModelGeneration.ts",
     "./src/models/protocols/pure/v1/engine/generation/V1_DatabaseBuilderInput.ts",
     "./src/models/protocols/pure/v1/engine/generation/V1_FileGenerationInput.ts",
     "./src/models/protocols/pure/v1/engine/generation/V1_GenerationConfigurationDescription.ts",
@@ -310,6 +328,13 @@
     "./src/models/protocols/pure/v1/model/packageableElements/domain/V1_StereotypePtr.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/domain/V1_TagPtr.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/domain/V1_TaggedValue.ts",
+    "./src/models/protocols/pure/v1/model/packageableElements/externalFormat/connection/V1_DSLExternalFormat_ExternalFormatConnection.ts",
+    "./src/models/protocols/pure/v1/model/packageableElements/externalFormat/connection/V1_DSLExternalFormat_UrlStream.ts",
+    "./src/models/protocols/pure/v1/model/packageableElements/externalFormat/schemaSet/V1_DSLExternalFormat_Schema.ts",
+    "./src/models/protocols/pure/v1/model/packageableElements/externalFormat/schemaSet/V1_DSLExternalFormat_SchemaSet.ts",
+    "./src/models/protocols/pure/v1/model/packageableElements/externalFormat/store/V1_BindingTransformer.ts",
+    "./src/models/protocols/pure/v1/model/packageableElements/externalFormat/store/V1_DSLExternalFormat_Binding.ts",
+    "./src/models/protocols/pure/v1/model/packageableElements/externalFormat/store/V1_DSLExternalFormat_ModelUnit.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/fileGeneration/V1_ConfigurationProperty.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/fileGeneration/V1_FileGenerationSpecification.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/function/V1_ConcreteFunctionDefinition.ts",
@@ -328,6 +353,7 @@
     "./src/models/protocols/pure/v1/model/packageableElements/mapping/V1_MappingInclude.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/mapping/V1_MappingTest.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/mapping/V1_MappingTestAssert.ts",
+    "./src/models/protocols/pure/v1/model/packageableElements/mapping/V1_MergeOperationClassMapping.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/mapping/V1_OperationClassMapping.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/mapping/V1_PropertyMapping.ts",
     "./src/models/protocols/pure/v1/model/packageableElements/mapping/V1_RelationalAssociationMapping.ts",
@@ -463,6 +489,7 @@
     "./src/models/protocols/pure/v1/transformation/pureGraph/from/V1_ServiceTransformer.ts",
     "./src/models/protocols/pure/v1/transformation/pureGraph/from/V1_ValueSpecificationTransformer.ts",
     "./src/models/protocols/pure/v1/transformation/pureGraph/from/executionPlan/V1_ExecutionPlanTransformer.ts",
+    "./src/models/protocols/pure/v1/transformation/pureGraph/to/V1_DSLExternalFormat_GraphBuilderHelper.ts",
     "./src/models/protocols/pure/v1/transformation/pureGraph/to/V1_ElementBuilder.ts",
     "./src/models/protocols/pure/v1/transformation/pureGraph/to/V1_ExecutionPlanBuilder.ts",
     "./src/models/protocols/pure/v1/transformation/pureGraph/to/V1_GraphBuilderContext.ts",
@@ -500,6 +527,7 @@
     "./src/models/protocols/pure/v1/transformation/pureProtocol/V1_PureProtocolSerialization.ts",
     "./src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_ConnectionSerializationHelper.ts",
     "./src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_CoreSerializationHelper.ts",
+    "./src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_DSLExternalFormat_ProtocolHelper.ts",
     "./src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_DatabaseSerializationHelper.ts",
     "./src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_DomainSerializationHelper.ts",
     "./src/models/protocols/pure/v1/transformation/pureProtocol/serializationHelpers/V1_FileGenerationSerializationHelper.ts",