@finos/legend-graph 29.0.2 → 29.0.3

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/from/V1_MappingTransformer.ts

@@ -49,6 +49,8 @@ import type { EmbeddedRelationalInstanceSetImplementation } from '../../../../..
 import type { InlineEmbeddedRelationalInstanceSetImplementation } from '../../../../../../../graph/metamodel/pure/packageableElements/store/relational/mapping/InlineEmbeddedRelationalInstanceSetImplementation.js';
 import type { OtherwiseEmbeddedRelationalInstanceSetImplementation } from '../../../../../../../graph/metamodel/pure/packageableElements/store/relational/mapping/OtherwiseEmbeddedRelationalInstanceSetImplementation.js';
 import type { InferableMappingElementIdValue } from '../../../../../../../graph/metamodel/pure/packageableElements/mapping/InferableMappingElementId.js';
+import { MappingIncludeMapping } from '../../../../../../../graph/metamodel/pure/packageableElements/mapping/MappingIncludeMapping.js';
+import { INTERNAL__UnknownMappingInclude } from '../../../../../../../graph/metamodel/pure/packageableElements/mapping/INTERNAL__UnknownMappingInclude.js';
 import type { MappingInclude } from '../../../../../../../graph/metamodel/pure/packageableElements/mapping/MappingInclude.js';
 import {
   type DEPRECATED__MappingTest,
@@ -97,7 +99,11 @@ import {
   V1_DEPRECATED__RelationalInputData,
 } from '../../../model/packageableElements/mapping/V1_DEPRECATED__MappingTest.js';
 import { V1_RawValueSpecificationTransformer } from './V1_RawValueSpecificationTransformer.js';
-import { V1_MappingInclude } from '../../../model/packageableElements/mapping/V1_MappingInclude.js';
+import {
+  type V1_MappingInclude,
+  V1_MappingIncludeMapping,
+} from '../../../model/packageableElements/mapping/V1_MappingInclude.js';
+import { V1_INTERNAL__UnknownMappingInclude } from '../../../model/packageableElements/mapping/V1_INTERNAL__UnknownMappingInclude.js';
 import { V1_EnumerationMapping } from '../../../model/packageableElements/mapping/V1_EnumerationMapping.js';
 import { V1_FlatDataPropertyMapping } from '../../../model/packageableElements/store/flatData/mapping/V1_FlatDataPropertyMapping.js';
 import { V1_PropertyPointer } from '../../../model/packageableElements/domain/V1_PropertyPointer.js';
@@ -464,18 +470,42 @@ export const V1_transformMappingTestSuite = (
 
 const transformMappingInclude = (
   element: MappingInclude,
+  context: V1_GraphTransformerContext,
 ): V1_MappingInclude => {
-  const mappingInclude = new V1_MappingInclude();
-  mappingInclude.includedMapping = element.included.valueForSerialization ?? '';
-  mappingInclude.sourceDatabasePath = element.storeSubstitutions.length
-    ? (element.storeSubstitutions[0] as SubstituteStore).original
-        .valueForSerialization ?? ''
-    : undefined;
-  mappingInclude.targetDatabasePath = element.storeSubstitutions.length
-    ? (element.storeSubstitutions[0] as SubstituteStore).substitute
-        .valueForSerialization ?? ''
-    : undefined;
-  return mappingInclude;
+  if (element instanceof INTERNAL__UnknownMappingInclude) {
+    const protocol = new V1_INTERNAL__UnknownMappingInclude();
+    protocol.content = element.content;
+    return protocol;
+  } else if (element instanceof MappingIncludeMapping) {
+    const mappingInclude = new V1_MappingIncludeMapping();
+    mappingInclude.includedMapping =
+      element.included.valueForSerialization ?? '';
+    mappingInclude.sourceDatabasePath = element.storeSubstitutions.length
+      ? (element.storeSubstitutions[0] as SubstituteStore).original
+          .valueForSerialization ?? ''
+      : undefined;
+    mappingInclude.targetDatabasePath = element.storeSubstitutions.length
+      ? (element.storeSubstitutions[0] as SubstituteStore).substitute
+          .valueForSerialization ?? ''
+      : undefined;
+    return mappingInclude;
+  }
+  const extraIncludeMappingTransformers = context.plugins.flatMap(
+    (plugin) =>
+      (
+        plugin as DSL_Mapping_PureProtocolProcessorPlugin_Extension
+      ).V1_getExtraMappingIncludeTransformers?.() ?? [],
+  );
+  for (const transformer of extraIncludeMappingTransformers) {
+    const mappingInclude = transformer(element, context);
+    if (mappingInclude) {
+      return mappingInclude;
+    }
+  }
+  throw new UnsupportedOperationError(
+    `Can't transform mapping include: no compatible transformer available from plugins`,
+    element,
+  );
 };
 
 // Class Mapping
@@ -1422,7 +1452,9 @@ export const V1_transformMapping = (
 ): V1_Mapping => {
   const mapping = new V1_Mapping();
   V1_initPackageableElement(mapping, element);
-  mapping.includedMappings = element.includes.map(transformMappingInclude);
+  mapping.includedMappings = element.includes.map((include) =>
+    transformMappingInclude(include, context),
+  );
   mapping.enumerationMappings = element.enumerationMappings.map(
     transformEnumerationMapping,
   );

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/from/V1_PackageableElementTransformer.ts

@@ -27,7 +27,7 @@ import type { Enumeration } from '../../../../../../../graph/metamodel/pure/pack
 import type { Measure } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Measure.js';
 import type { Class } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Class.js';
 import type { Association } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Association.js';
-import type { ConcreteFunctionDefinition } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/ConcreteFunctionDefinition.js';
+import type { ConcreteFunctionDefinition } from '../../../../../../../graph/metamodel/pure/packageableElements/function/ConcreteFunctionDefinition.js';
 import type { FlatData } from '../../../../../../../graph/metamodel/pure/packageableElements/store/flatData/model/FlatData.js';
 import type { Database } from '../../../../../../../graph/metamodel/pure/packageableElements/store/relational/model/Database.js';
 import type { Mapping } from '../../../../../../../graph/metamodel/pure/packageableElements/mapping/Mapping.js';
@@ -71,6 +71,8 @@ import { V1_transformExecutionEnvirnoment } from './V1_ExecutionEnvironmentTrans
 import type { INTERNAL__UnknownPackageableElement } from '../../../../../../../graph/metamodel/pure/packageableElements/INTERNAL__UnknownPackageableElement.js';
 import { V1_INTERNAL__UnknownPackageableElement } from '../../../model/packageableElements/V1_INTERNAL__UnknownPackageableElement.js';
 import { V1_initPackageableElement } from './V1_CoreTransformerHelper.js';
+import type { INTERNAL__UnknownFunctionActivator } from '../../../../../../../graph/metamodel/pure/packageableElements/function/INTERNAL__UnknownFunctionActivator.js';
+import { V1_INTERNAL__UnknownFunctionActivator } from '../../../model/packageableElements/function/V1_INTERNAL__UnknownFunctionActivator.js';
 
 class V1_PackageableElementTransformer
   implements PackageableElementVisitor<V1_PackageableElement>
@@ -110,6 +112,16 @@ class V1_PackageableElementTransformer
     return protocol;
   }
 
+  visit_INTERNAL__UnknownFunctionActivator(
+    element: INTERNAL__UnknownFunctionActivator,
+  ): V1_PackageableElement {
+    const protocol = new V1_INTERNAL__UnknownFunctionActivator();
+    V1_initPackageableElement(protocol, element);
+    protocol.function = element.function.valueForSerialization ?? '';
+    protocol.content = element.content;
+    return protocol;
+  }
+
   visit_Package(element: Package): V1_PackageableElement {
     throw new UnsupportedOperationError();
   }

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/V1_ElementFifthPassBuilder.ts

@@ -46,6 +46,7 @@ import type { V1_SectionIndex } from '../../../model/packageableElements/section
 import type { V1_DataElement } from '../../../model/packageableElements/data/V1_DataElement.js';
 import type { V1_ExecutionEnvironmentInstance } from '../../../model/packageableElements/service/V1_ExecutionEnvironmentInstance.js';
 import type { V1_INTERNAL__UnknownPackageableElement } from '../../../model/packageableElements/V1_INTERNAL__UnknownPackageableElement.js';
+import type { V1_INTERNAL__UnknownFunctionActivator } from '../../../model/packageableElements/function/V1_INTERNAL__UnknownFunctionActivator.js';
 
 export class V1_ElementFifthPassBuilder
   implements V1_PackageableElementVisitor<void>
@@ -68,6 +69,12 @@ export class V1_ElementFifthPassBuilder
     throw new UnsupportedOperationError();
   }
 
+  visit_INTERNAL__UnknownFunctionActivator(
+    element: V1_INTERNAL__UnknownFunctionActivator,
+  ): void {
+    throw new UnsupportedOperationError();
+  }
+
   visit_Profile(element: V1_Profile): void {
     throw new UnsupportedOperationError();
   }

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/V1_ElementFirstPassBuilder.ts

@@ -21,7 +21,7 @@ import { Enumeration } from '../../../../../../../graph/metamodel/pure/packageab
 import { Measure } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Measure.js';
 import { Class } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Class.js';
 import { Association } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Association.js';
-import { ConcreteFunctionDefinition } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/ConcreteFunctionDefinition.js';
+import { ConcreteFunctionDefinition } from '../../../../../../../graph/metamodel/pure/packageableElements/function/ConcreteFunctionDefinition.js';
 import { FlatData } from '../../../../../../../graph/metamodel/pure/packageableElements/store/flatData/model/FlatData.js';
 import { Database } from '../../../../../../../graph/metamodel/pure/packageableElements/store/relational/model/Database.js';
 import { Mapping } from '../../../../../../../graph/metamodel/pure/packageableElements/mapping/Mapping.js';
@@ -70,6 +70,8 @@ import type { V1_ExecutionEnvironmentInstance } from '../../../model/packageable
 import { ExecutionEnvironmentInstance } from '../../../../../../../graph/metamodel/pure/packageableElements/service/ExecutionEnvironmentInstance.js';
 import type { V1_INTERNAL__UnknownPackageableElement } from '../../../model/packageableElements/V1_INTERNAL__UnknownPackageableElement.js';
 import { INTERNAL__UnknownPackageableElement } from '../../../../../../../graph/metamodel/pure/packageableElements/INTERNAL__UnknownPackageableElement.js';
+import { INTERNAL__UnknownFunctionActivator } from '../../../../../../../graph/metamodel/pure/packageableElements/function/INTERNAL__UnknownFunctionActivator.js';
+import type { V1_INTERNAL__UnknownFunctionActivator } from '../../../model/packageableElements/function/V1_INTERNAL__UnknownFunctionActivator.js';
 
 export class V1_ElementFirstPassBuilder
   implements V1_PackageableElementVisitor<PackageableElement>
@@ -129,6 +131,33 @@ export class V1_ElementFirstPassBuilder
     return metamodel;
   }
 
+  visit_INTERNAL__UnknownFunctionActivator(
+    element: V1_INTERNAL__UnknownFunctionActivator,
+  ): PackageableElement {
+    assertNonEmptyString(
+      element.package,
+      `Function activator 'package' field is missing or empty`,
+    );
+    assertNonEmptyString(
+      element.name,
+      `Function activator 'name' field is missing or empty`,
+    );
+    const metamodel = new INTERNAL__UnknownFunctionActivator(element.name);
+    const path = V1_buildFullPath(element.package, element.name);
+    V1_checkDuplicatedElement(path, this.context, this.elementPathCache);
+    this.context.currentSubGraph.setOwnFunctionActivator(path, metamodel);
+    addElementToPackage(
+      getOrCreateGraphPackage(
+        this.context.currentSubGraph,
+        element.package,
+        this.packageCache,
+      ),
+      metamodel,
+    );
+    metamodel.content = element.content;
+    return metamodel;
+  }
+
   visit_SectionIndex(element: V1_SectionIndex): PackageableElement {
     assertNonEmptyString(
       element.package,

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/V1_ElementFourthPassBuilder.ts

@@ -54,6 +54,7 @@ import { V1_buildTestSuite } from './helpers/V1_TestBuilderHelper.js';
 import { MappingTestSuite } from '../../../../../../../graph/metamodel/pure/packageableElements/mapping/MappingTestSuite.js';
 import type { V1_ExecutionEnvironmentInstance } from '../../../model/packageableElements/service/V1_ExecutionEnvironmentInstance.js';
 import type { V1_INTERNAL__UnknownPackageableElement } from '../../../model/packageableElements/V1_INTERNAL__UnknownPackageableElement.js';
+import type { V1_INTERNAL__UnknownFunctionActivator } from '../../../model/packageableElements/function/V1_INTERNAL__UnknownFunctionActivator.js';
 
 export class V1_ElementFourthPassBuilder
   implements V1_PackageableElementVisitor<void>
@@ -76,6 +77,12 @@ export class V1_ElementFourthPassBuilder
     throw new UnsupportedOperationError();
   }
 
+  visit_INTERNAL__UnknownFunctionActivator(
+    element: V1_INTERNAL__UnknownFunctionActivator,
+  ): void {
+    throw new UnsupportedOperationError();
+  }
+
   visit_Profile(element: V1_Profile): void {
     throw new UnsupportedOperationError();
   }

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/V1_ElementSecondPassBuilder.ts

@@ -23,6 +23,7 @@ import {
   assertTrue,
   LogEvent,
   guaranteeType,
+  guaranteeNonNullable,
 } from '@finos/legend-shared';
 import { Stereotype } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Stereotype.js';
 import { Tag } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Tag.js';
@@ -90,6 +91,15 @@ import { PostValidation } from '../../../../../../../graph/metamodel/pure/packag
 import type { V1_ExecutionEnvironmentInstance } from '../../../model/packageableElements/service/V1_ExecutionEnvironmentInstance.js';
 import { V1_buildExecutionParameters } from './V1_ExecutionEnvironmentBuilderHelper.js';
 import type { V1_INTERNAL__UnknownPackageableElement } from '../../../model/packageableElements/V1_INTERNAL__UnknownPackageableElement.js';
+import type { V1_INTERNAL__UnknownFunctionActivator } from '../../../model/packageableElements/function/V1_INTERNAL__UnknownFunctionActivator.js';
+import { PackageableElementExplicitReference } from '../../../../../../../graph/metamodel/pure/packageableElements/PackageableElementReference.js';
+import { generateFunctionPrettyName } from '../../../../../../../graph/helpers/PureLanguageHelper.js';
+import type { DSL_Mapping_PureProtocolProcessorPlugin_Extension } from '../../../../extensions/DSL_Mapping_PureProtocolProcessorPlugin_Extension.js';
+import {
+  type V1_MappingInclude,
+  V1_MappingIncludeMapping,
+} from '../../../model/packageableElements/mapping/V1_MappingInclude.js';
+import { V1_INTERNAL__UnknownMappingInclude } from '../../../model/packageableElements/mapping/V1_INTERNAL__UnknownMappingInclude.js';
 
 export class V1_ElementSecondPassBuilder
   implements V1_PackageableElementVisitor<void>
@@ -112,6 +122,40 @@ export class V1_ElementSecondPassBuilder
     throw new UnsupportedOperationError();
   }
 
+  visit_INTERNAL__UnknownFunctionActivator(
+    element: V1_INTERNAL__UnknownFunctionActivator,
+  ): void {
+    const metamodel = this.context.currentSubGraph.getOwnFunctionActivator(
+      V1_buildFullPath(element.package, element.name),
+    );
+    // this.context.graph.functions.find((fn) => {
+    //   console.log(
+    //     generateFunctionPrettyName(fn, {
+    //       fullPath: true,
+    //       spacing: false,
+    //     }),
+    //     element.function.replaceAll(/\s*/gu, ''),
+    //   );
+    //   return (
+    //     generateFunctionPrettyName(fn, {
+    //       fullPath: true,
+    //       spacing: false,
+    //     }) === element.function.replaceAll(/\s*/gu, '')
+    //   );
+    // });
+    metamodel.function = PackageableElementExplicitReference.create(
+      guaranteeNonNullable(
+        this.context.graph.functions.find(
+          (fn) =>
+            generateFunctionPrettyName(fn, {
+              fullPath: true,
+              spacing: false,
+            }) === element.function.replaceAll(/\s*/gu, ''),
+        ),
+      ),
+    );
+  }
+
   visit_Profile(element: V1_Profile): void {
     const profile = this.context.currentSubGraph.getOwnProfile(
       V1_buildFullPath(element.package, element.name),
@@ -285,22 +329,47 @@ export class V1_ElementSecondPassBuilder
     );
   }
 
+  getMappingIdentifier(protocol: V1_MappingInclude): string | undefined {
+    if (protocol instanceof V1_INTERNAL__UnknownMappingInclude) {
+      return undefined;
+    }
+    if (protocol instanceof V1_MappingIncludeMapping) {
+      return protocol.includedMapping;
+    }
+    const extraIncludeMappingIdentifierBuilders =
+      this.context.extensions.plugins.flatMap(
+        (plugin) =>
+          (
+            plugin as DSL_Mapping_PureProtocolProcessorPlugin_Extension
+          ).V1_getExtraMappingIncludeIdentifierBuilders?.() ?? [],
+      );
+    for (const builder of extraIncludeMappingIdentifierBuilders) {
+      const builtIdentifier = builder(protocol);
+      if (builtIdentifier) {
+        return builtIdentifier;
+      }
+    }
+    throw new UnsupportedOperationError(
+      `Can't build mapping include identifier: no compatible builder available from plugins`,
+      protocol,
+    );
+  }
+
   visit_Mapping(element: V1_Mapping): void {
     const mapping = this.context.currentSubGraph.getOwnMapping(
       V1_buildFullPath(element.package, element.name),
     );
     const mappingIncludesSet = new Set<string>();
     mapping.includes = element.includedMappings.map((mappingInclude) => {
-      const includedMappingPath = mappingInclude.includedMapping;
-      assertNonEmptyString(
-        includedMappingPath,
-        `Mapping include path is missing or empty`,
-      );
-      assertTrue(
-        !mappingIncludesSet.has(includedMappingPath),
-        `Duplicated mapping include '${includedMappingPath}' in mapping '${mapping.path}'`,
-      );
-      mappingIncludesSet.add(includedMappingPath);
+      const includedMappingIdentifier =
+        this.getMappingIdentifier(mappingInclude);
+      if (includedMappingIdentifier) {
+        assertTrue(
+          !mappingIncludesSet.has(includedMappingIdentifier),
+          `Duplicated mapping include '${includedMappingIdentifier}' in mapping '${mapping.path}'`,
+        );
+        mappingIncludesSet.add(includedMappingIdentifier);
+      }
       return V1_buildMappingInclude(mappingInclude, this.context, mapping);
     });
     mapping.enumerationMappings = element.enumerationMappings.map(

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/V1_ElementThirdPassBuilder.ts

@@ -61,6 +61,7 @@ import type { V1_DataElement } from '../../../model/packageableElements/data/V1_
 import { V1_TEMPORARY__buildMilestoningClass } from './helpers/V1_MilestoneBuilderHelper.js';
 import type { V1_ExecutionEnvironmentInstance } from '../../../model/packageableElements/service/V1_ExecutionEnvironmentInstance.js';
 import type { V1_INTERNAL__UnknownPackageableElement } from '../../../model/packageableElements/V1_INTERNAL__UnknownPackageableElement.js';
+import type { V1_INTERNAL__UnknownFunctionActivator } from '../../../model/packageableElements/function/V1_INTERNAL__UnknownFunctionActivator.js';
 
 export class V1_ElementThirdPassBuilder
   implements V1_PackageableElementVisitor<void>
@@ -83,6 +84,12 @@ export class V1_ElementThirdPassBuilder
     throw new UnsupportedOperationError();
   }
 
+  visit_INTERNAL__UnknownFunctionActivator(
+    element: V1_INTERNAL__UnknownFunctionActivator,
+  ): void {
+    throw new UnsupportedOperationError();
+  }
+
   visit_Profile(element: V1_Profile): void {
     throw new UnsupportedOperationError();
   }

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/V1_GraphBuilderContext.ts

@@ -42,7 +42,7 @@ import type { Enumeration } from '../../../../../../../graph/metamodel/pure/pack
 import type { Association } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Association.js';
 import type { Mapping } from '../../../../../../../graph/metamodel/pure/packageableElements/mapping/Mapping.js';
 import type { Profile } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/Profile.js';
-import type { ConcreteFunctionDefinition } from '../../../../../../../graph/metamodel/pure/packageableElements/domain/ConcreteFunctionDefinition.js';
+import type { ConcreteFunctionDefinition } from '../../../../../../../graph/metamodel/pure/packageableElements/function/ConcreteFunctionDefinition.js';
 import type { Store } from '../../../../../../../graph/metamodel/pure/packageableElements/store/Store.js';
 import type { Service } from '../../../../../../../graph/metamodel/pure/packageableElements/service/Service.js';
 import type { FlatData } from '../../../../../../../graph/metamodel/pure/packageableElements/store/flatData/model/FlatData.js';

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/V1_GraphBuilderExtensions.ts

@@ -43,6 +43,7 @@ import { V1_Service } from '../../../model/packageableElements/service/V1_Servic
 import { V1_Store } from '../../../model/packageableElements/store/V1_Store.js';
 import { V1_PackageableElement } from '../../../model/packageableElements/V1_PackageableElement.js';
 import type { V1_ElementBuilder } from './V1_ElementBuilder.js';
+import { V1_FunctionActivator } from '../../../model/packageableElements/function/V1_FunctionActivator.js';
 
 const FORBIDDEN_BUILDER_PROTOCOL_CLASSES = new Set<
   GenericClazz<V1_PackageableElement>
@@ -57,6 +58,7 @@ const FORBIDDEN_BUILDER_PROTOCOL_CLASSES = new Set<
   V1_Unit,
   V1_SectionIndex,
   V1_Store,
+  V1_FunctionActivator,
   V1_Mapping,
   V1_PackageableConnection,
   V1_PackageableRuntime,

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/helpers/V1_ConnectionBuilderHelper.ts

@@ -278,6 +278,7 @@ class V1_ConnectionBuilder implements V1_ConnectionVisitor<Connection> {
         this.context,
       ),
     );
+    val.localMode = connection.localMode;
     val.timeZone = connection.timeZone;
     val.quoteIdentifiers = connection.quoteIdentifiers;
     val.postProcessors = connection.postProcessors.map((p) =>

package/src/graph-manager/protocol/pure/v1/transformation/pureGraph/to/helpers/V1_MappingBuilderHelper.ts

@@ -46,7 +46,9 @@ import {
   PackageableElementExplicitReference,
 } from '../../../../../../../../graph/metamodel/pure/packageableElements/PackageableElementReference.js';
 import { EnumValueImplicitReference } from '../../../../../../../../graph/metamodel/pure/packageableElements/domain/EnumValueReference.js';
-import { MappingInclude } from '../../../../../../../../graph/metamodel/pure/packageableElements/mapping/MappingInclude.js';
+import type { MappingInclude } from '../../../../../../../../graph/metamodel/pure/packageableElements/mapping/MappingInclude.js';
+import { MappingIncludeMapping } from '../../../../../../../../graph/metamodel/pure/packageableElements/mapping/MappingIncludeMapping.js';
+import { INTERNAL__UnknownMappingInclude } from '../../../../../../../../graph/metamodel/pure/packageableElements/mapping/INTERNAL__UnknownMappingInclude.js';
 import { SubstituteStore } from '../../../../../../../../graph/metamodel/pure/packageableElements/mapping/SubstituteStore.js';
 import type { SetImplementation } from '../../../../../../../../graph/metamodel/pure/packageableElements/mapping/SetImplementation.js';
 import { InferableMappingElementRootImplicitValue } from '../../../../../../../../graph/metamodel/pure/packageableElements/mapping/InferableMappingElementRoot.js';
@@ -65,7 +67,11 @@ import {
   V1_DEPRECATED__RelationalInputData,
 } from '../../../../model/packageableElements/mapping/V1_DEPRECATED__MappingTest.js';
 import type { V1_ClassMapping } from '../../../../model/packageableElements/mapping/V1_ClassMapping.js';
-import type { V1_MappingInclude } from '../../../../model/packageableElements/mapping/V1_MappingInclude.js';
+import {
+  type V1_MappingInclude,
+  V1_MappingIncludeMapping,
+} from '../../../../model/packageableElements/mapping/V1_MappingInclude.js';
+import { V1_INTERNAL__UnknownMappingInclude } from '../../../../model/packageableElements/mapping/V1_INTERNAL__UnknownMappingInclude.js';
 import { V1_buildRawLambdaWithResolvedPaths } from './V1_ValueSpecificationPathResolver.js';
 import {
   getAllClassMappings,
@@ -100,6 +106,7 @@ import type { V1_MappingStoreTestData } from '../../../../model/packageableEleme
 import { StoreTestData } from '../../../../../../../../graph/metamodel/pure/packageableElements/mapping/MappingStoreTestData.js';
 import { V1_buildEmbeddedData } from './V1_DataElementBuilderHelper.js';
 import { ModelStore } from '../../../../../../../../graph/metamodel/pure/packageableElements/store/modelToModel/model/ModelStore.js';
+import type { DSL_Mapping_PureProtocolProcessorPlugin_Extension } from '../../../../../extensions/DSL_Mapping_PureProtocolProcessorPlugin_Extension.js';
 
 export const V1_getInferredClassMappingId = (
   _class: Class,
@@ -212,20 +219,43 @@ export const V1_buildMappingInclude = (
   context: V1_GraphBuilderContext,
   parentMapping: Mapping,
 ): MappingInclude => {
-  const includedMapping = new MappingInclude(
-    parentMapping,
-    context.resolveMapping(mappingInclude.includedMapping),
-  );
-  if (mappingInclude.sourceDatabasePath && mappingInclude.targetDatabasePath) {
-    includedMapping.storeSubstitutions.push(
-      new SubstituteStore(
-        includedMapping,
-        context.resolveStore(mappingInclude.sourceDatabasePath),
-        context.resolveStore(mappingInclude.targetDatabasePath),
-      ),
+  if (mappingInclude instanceof V1_INTERNAL__UnknownMappingInclude) {
+    return new INTERNAL__UnknownMappingInclude(parentMapping);
+  } else if (mappingInclude instanceof V1_MappingIncludeMapping) {
+    const includedMapping = new MappingIncludeMapping(
+      parentMapping,
+      context.resolveMapping(mappingInclude.includedMapping),
     );
+    if (
+      mappingInclude.sourceDatabasePath &&
+      mappingInclude.targetDatabasePath
+    ) {
+      includedMapping.storeSubstitutions.push(
+        new SubstituteStore(
+          includedMapping,
+          context.resolveStore(mappingInclude.sourceDatabasePath),
+          context.resolveStore(mappingInclude.targetDatabasePath),
+        ),
+      );
+    }
+    return includedMapping;
+  }
+  const extraIncludeMappingBuilders = context.extensions.plugins.flatMap(
+    (plugin) =>
+      (
+        plugin as DSL_Mapping_PureProtocolProcessorPlugin_Extension
+      ).V1_getExtraMappingIncludeBuilders?.() ?? [],
+  );
+  for (const builder of extraIncludeMappingBuilders) {
+    const builtInclude = builder(mappingInclude, parentMapping, context);
+    if (builtInclude) {
+      return builtInclude;
+    }
   }
-  return includedMapping;
+  throw new UnsupportedOperationError(
+    `Can't transform mapping include: no compatible transformer available from plugins`,
+    mappingInclude,
+  );
 };
 
 const buildMappingStoreTestData = (

package/src/graph-manager/protocol/pure/v1/transformation/pureProtocol/V1_PackageableElementSerialization.ts

@@ -106,6 +106,7 @@ import {
 } from './serializationHelpers/V1_ExecutionEnvironmentSerializationHelper.js';
 import type { V1_ExecutionEnvironmentInstance } from '../../model/packageableElements/service/V1_ExecutionEnvironmentInstance.js';
 import { V1_INTERNAL__UnknownPackageableElement } from '../../model/packageableElements/V1_INTERNAL__UnknownPackageableElement.js';
+import type { V1_INTERNAL__UnknownFunctionActivator } from '../../model/packageableElements/function/V1_INTERNAL__UnknownFunctionActivator.js';
 
 class V1_PackageableElementSerializer
   implements V1_PackageableElementVisitor<PlainObject<V1_PackageableElement>>
@@ -140,6 +141,12 @@ class V1_PackageableElementSerializer
     return element.content;
   }
 
+  visit_INTERNAL__UnknownFunctionActivator(
+    element: V1_INTERNAL__UnknownFunctionActivator,
+  ): PlainObject<V1_PackageableElement> {
+    return element.content;
+  }
+
   visit_Profile(element: V1_Profile): PlainObject<V1_PackageableElement> {
     return serialize(V1_profileModelSchema, element);
   }

package/src/graph-manager/protocol/pure/v1/transformation/pureProtocol/serializationHelpers/V1_DatabaseSerializationHelper.ts

@@ -538,6 +538,7 @@ const V1_setupRelationalDatabaseConnectionModelSchema = (
       (val) => V1_serializeDatasourceSpecification(val, plugins),
       (val) => V1_deserializeDatasourceSpecification(val, plugins),
     ),
+    localMode: optional(primitive()),
     store: alias('element', primitive()),
     quoteIdentifiers: optional(primitive()),
     timeZone: optional(primitive()),

package/src/graph-manager/protocol/pure/v1/transformation/pureProtocol/serializationHelpers/V1_DomainSerializationHelper.ts

@@ -52,6 +52,7 @@ import {
   V1_rawLambdaModelSchema,
   V1_rawVariableModelSchema,
 } from './V1_RawValueSpecificationSerializationHelper.js';
+import { V1_INTERNAL__UnknownFunctionActivator } from '../../../model/packageableElements/function/V1_INTERNAL__UnknownFunctionActivator.js';
 
 export const V1_CLASS_ELEMENT_PROTOCOL_TYPE = 'class';
 export const V1_PROFILE_ELEMENT_PROTOCOL_TYPE = 'profile';
@@ -277,3 +278,10 @@ export const V1_functionModelSchema = createModelSchema(
     }),
   },
 );
+
+export const V1_INTERNAL__UnknownFunctionActivatorModelSchema =
+  createModelSchema(V1_INTERNAL__UnknownFunctionActivator, {
+    function: primitive(),
+    name: primitive(),
+    package: primitive(),
+  });