@finos/legend-graph 2.1.3 → 3.0.0

package/src/GraphManagerState.ts

@@ -15,14 +15,12 @@
  */
 
 import {
-  type GeneratorFn,
   type Log,
-  LogEvent,
   uniq,
   ActionState,
   assertErrorThrown,
 } from '@finos/legend-shared';
-import { action, flow, flowResult, makeObservable, observable } from 'mobx';
+import { action, makeObservable, observable } from 'mobx';
 import { DependencyManager } from './graph/DependencyManager';
 import {
   CoreModel,
@@ -34,8 +32,8 @@ import type {
   AbstractPureGraphManager,
   GraphBuilderOptions,
 } from './graphManager/AbstractPureGraphManager';
-import { GRAPH_MANAGER_EVENT } from './graphManager/GraphManagerEvent';
 import type { GraphPluginManager } from './GraphPluginManager';
+import { ROOT_PACKAGE_NAME } from './MetaModelConst';
 import { AssociationImplementation } from './models/metamodels/pure/packageableElements/mapping/AssociationImplementation';
 import type { EnumerationMapping } from './models/metamodels/pure/packageableElements/mapping/EnumerationMapping';
 import { InstanceSetImplementation } from './models/metamodels/pure/packageableElements/mapping/InstanceSetImplementation';
@@ -64,7 +62,6 @@ export class GraphManagerState {
     makeObservable(this, {
       graph: observable,
       resetGraph: action,
-      initializeSystem: flow,
     });
 
     this.pluginManager = pluginManager;
@@ -84,18 +81,16 @@ export class GraphManagerState {
    * Right now the essential profiles have been extracted from Pure to load the minimum system models.
    * We might add more system entities as needed until the system model project(s) are setup.
    */
-  *initializeSystem(options?: GraphBuilderOptions): GeneratorFn<void> {
+  async initializeSystem(options?: GraphBuilderOptions): Promise<void> {
     if (!this.initSystemState.isInInitialState) {
       return;
     }
     try {
       this.initSystemState.inProgress();
-      yield flowResult(
-        this.graphManager.buildSystem(
-          this.coreModel,
-          this.systemModel,
-          options,
-        ),
+      await this.graphManager.buildSystem(
+        this.coreModel,
+        this.systemModel,
+        options,
       );
       this.systemModel.initializeAutoImports();
       this.initSystemState.pass();
@@ -216,35 +211,6 @@ export class GraphManagerState {
     return uniq(mappedProperties);
   }
 
-  /**
-   * Call `get hashCode()` on each element once so we trigger the first time we compute the hash for that element.
-   * This plays well with `keepAlive` flag on each of the element `get hashCode()` function. This is due to
-   * the fact that we want to get hashCode inside a `setTimeout()` to make this non-blocking, but that way `mobx` will
-   * not trigger memoization on computed so we need to enable `keepAlive`
-   */
-  *precomputeHashes(): GeneratorFn<void> {
-    const startTime = Date.now();
-    if (this.graph.allOwnElements.length) {
-      yield Promise.all<void>(
-        this.graph.allOwnElements.map(
-          (element) =>
-            new Promise((resolve) =>
-              setTimeout(() => {
-                element.hashCode; // manually trigger hash code recomputation
-                resolve();
-              }, 0),
-            ),
-        ),
-      );
-    }
-    this.log.info(
-      LogEvent.create(GRAPH_MANAGER_EVENT.GRAPH_HASHES_PRECOMPUTED),
-      '[ASYNC]',
-      Date.now() - startTime,
-      'ms',
-    );
-  }
-
   /**
    * Filter the list of system elements that will be shown in selection options
    * to users. This is helpful to avoid overwhelming and confusing users in form
@@ -261,4 +227,8 @@ export class GraphManagerState {
       allowedSystemElements.includes(element.path),
     );
   }
+
+  isElementReadOnly(element: PackageableElement): boolean {
+    return element.getRoot().path !== ROOT_PACKAGE_NAME.MAIN;
+  }
 }

package/src/GraphManagerTestUtils.tsx

@@ -15,11 +15,11 @@
  */
 
 /// <reference types="jest-extended" />
-import { flowResult } from 'mobx';
 import {
   type LoggerPlugin,
   Log,
   AbstractPluginManager,
+  promisify,
 } from '@finos/legend-shared';
 import type { PureGraphManagerPlugin } from './graphManager/PureGraphManagerPlugin';
 import { GraphManagerState } from './GraphManagerState';
@@ -171,13 +171,11 @@ export const TEST__buildGraphWithEntities = async (
   entities: Entity[],
   options?: GraphBuilderOptions,
 ): Promise<void> => {
-  await flowResult(graphManagerState.initializeSystem(options));
-  await flowResult(
-    graphManagerState.graphManager.buildGraph(
-      graphManagerState.graph,
-      entities,
-      options,
-    ),
+  await graphManagerState.initializeSystem(options);
+  await graphManagerState.graphManager.buildGraph(
+    graphManagerState.graph,
+    entities,
+    options,
   );
 };
 
@@ -185,19 +183,14 @@ export const TEST__checkGraphHashUnchanged = async (
   graphManagerState: GraphManagerState,
   entities: Entity[],
 ): Promise<void> => {
-  await flowResult(graphManagerState.precomputeHashes());
   const originalHashesIndex =
     await graphManagerState.graphManager.buildHashesIndex(entities);
   const graphHashesIndex = new Map<string, string>();
   await Promise.all<void>(
-    graphManagerState.graph.allOwnElements.map(
-      (element) =>
-        new Promise((resolve) =>
-          setTimeout(() => {
-            graphHashesIndex.set(element.path, element.hashCode);
-            resolve();
-          }, 0),
-        ),
+    graphManagerState.graph.allOwnElements.map((element) =>
+      promisify(() => {
+        graphHashesIndex.set(element.path, element.hashCode);
+      }),
     ),
   );
   expect(
@@ -239,12 +232,10 @@ export const TEST__checkBuildingResolvedElements = async (
   resolvedEntities: Entity[],
 ): Promise<void> => {
   const graphManagerState = TEST__getTestGraphManagerState();
-  await flowResult(graphManagerState.initializeSystem());
-  await flowResult(
-    graphManagerState.graphManager.buildGraph(
-      graphManagerState.graph,
-      entities,
-    ),
+  await graphManagerState.initializeSystem();
+  await graphManagerState.graphManager.buildGraph(
+    graphManagerState.graph,
+    entities,
   );
   const transformedEntities = graphManagerState.graph.allOwnElements.map(
     (element) => graphManagerState.graphManager.elementToEntity(element),

package/src/MetaModelConst.ts

@@ -196,7 +196,6 @@ export enum CORE_HASH_STRUCTURE {
   DATABASE_TABLE_COLUMN = 'DATABASE_TABLE_COLUMN',
   // relational operation element
   RELATIONAL = 'RELATIONAL',
-  RELATIONAL_OPERATION_FUNCTION = 'RELATIONAL_OPERATION_FUNCTION',
   RELATIONAL_OPERATION_DYNA_FUNC = 'RELATIONAL_OPERATION_DYNA_FUNC',
   RELATIONAL_OPERATION_ELEMENTS_WITH_JOINS = 'RELATIONAL_OPERATION_ELEMENTS_WITH_JOINS',
   RELATIONAL_OPERATION_LITERAL = 'RELATIONAL_OPERATION_LITERAL',

package/src/graph/BasicModel.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 
-import { observable, computed, action, flow, makeObservable } from 'mobx';
 import {
   type Clazz,
   type GeneratorFn,
@@ -25,6 +24,7 @@ import {
   guaranteeNonNullable,
   IllegalStateError,
   returnUndefOnError,
+  promisify,
 } from '@finos/legend-shared';
 import {
   type ROOT_PACKAGE_NAME,
@@ -64,7 +64,7 @@ import {
 import {
   _package_addElement,
   _package_deleteElement,
-} from '../models/GraphModifierHelper';
+} from '../helpers/DomainHelper';
 
 const FORBIDDEN_EXTENSION_ELEMENT_CLASS = new Set([
   PackageableElement,
@@ -98,11 +98,11 @@ const FORBIDDEN_EXTENSION_ELEMENT_CLASS = new Set([
  */
 export abstract class BasicModel {
   root: Package;
+  readonly extensions: PureGraphExtension<PackageableElement>[] = [];
 
   // FIXME: to be moved, this is graph-manager logic and should be moved elsewhere
   buildState = ActionState.create();
 
-  private readonly extensions: PureGraphExtension<PackageableElement>[] = [];
   private elementSectionMap = new Map<string, Section>();
 
   private sectionIndicesIndex = new Map<string, SectionIndex>();
@@ -131,78 +131,6 @@ export abstract class BasicModel {
     rootPackageName: ROOT_PACKAGE_NAME,
     extensionElementClasses: Clazz<PackageableElement>[],
   ) {
-    makeObservable<
-      BasicModel,
-      | 'elementSectionMap'
-      | 'sectionIndicesIndex'
-      | 'profilesIndex'
-      | 'typesIndex'
-      | 'associationsIndex'
-      | 'functionsIndex'
-      | 'storesIndex'
-      | 'mappingsIndex'
-      | 'connectionsIndex'
-      | 'runtimesIndex'
-      | 'servicesIndex'
-      | 'generationSpecificationsIndex'
-      | 'fileGenerationsIndex'
-      | 'extensions'
-    >(this, {
-      elementSectionMap: observable,
-      sectionIndicesIndex: observable,
-      profilesIndex: observable,
-      typesIndex: observable,
-      associationsIndex: observable,
-      functionsIndex: observable,
-      storesIndex: observable,
-      mappingsIndex: observable,
-      connectionsIndex: observable,
-      runtimesIndex: observable,
-      servicesIndex: observable,
-      generationSpecificationsIndex: observable,
-      fileGenerationsIndex: observable,
-      extensions: observable,
-
-      ownSectionIndices: computed,
-      ownProfiles: computed,
-      ownEnumerations: computed,
-      ownMeasures: computed,
-      ownUnits: computed,
-      ownClasses: computed,
-      ownTypes: computed,
-      ownAssociations: computed,
-      ownFunctions: computed,
-      ownStores: computed,
-      ownFlatDatas: computed,
-      ownDatabases: computed,
-      ownMappings: computed,
-      ownServices: computed,
-      ownRuntimes: computed,
-      ownConnections: computed,
-      ownFileGenerations: computed,
-      ownGenerationSpecifications: computed,
-      allOwnElements: computed,
-
-      dispose: flow,
-
-      setOwnSection: action,
-      setOwnSectionIndex: action,
-      setOwnProfile: action,
-      setOwnType: action,
-      setOwnAssociation: action,
-      setOwnFunction: action,
-      setOwnStore: action,
-      setOwnMapping: action,
-      setOwnConnection: action,
-      setOwnRuntime: action,
-      setOwnService: action,
-      setOwnGenerationSpecification: action,
-      setOwnFileGeneration: action,
-      deleteOwnElement: action,
-      renameOwnElement: action,
-      TEMPORARY__deleteOwnSectionIndex: action,
-    });
-
     this.root = new Package(rootPackageName);
     this.extensions = this.createGraphExtensions(extensionElementClasses);
   }
@@ -443,19 +371,16 @@ export abstract class BasicModel {
   *dispose(): GeneratorFn<void> {
     if (this.allOwnElements.length) {
       yield Promise.all<void>(
-        this.allOwnElements.map(
-          (element) =>
-            new Promise((resolve) =>
-              setTimeout(() => {
-                element.dispose();
-                resolve();
-              }, 0),
-            ),
+        this.allOwnElements.map((element) =>
+          promisify(() => {
+            element.dispose();
+          }),
         ),
       );
     }
   }
 
+  // TODO
   buildPath = (
     packagePath: string | undefined,
     name: string | undefined,

package/src/graph/DependencyManager.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 
-import { observable, computed, makeObservable } from 'mobx';
 import { ROOT_PACKAGE_NAME } from '../MetaModelConst';
 import {
   type Clazz,
@@ -66,30 +65,6 @@ export class DependencyManager {
   private readonly extensionElementClasses: Clazz<PackageableElement>[];
 
   constructor(extensionElementClasses: Clazz<PackageableElement>[]) {
-    makeObservable(this, {
-      root: observable,
-      projectDependencyModelsIndex: observable,
-      allElements: computed,
-      models: computed,
-      profiles: computed,
-      enumerations: computed,
-      measures: computed,
-      units: computed,
-      classes: computed,
-      types: computed,
-      associations: computed,
-      functions: computed,
-      stores: computed,
-      databases: computed,
-      mappings: computed,
-      services: computed,
-      runtimes: computed,
-      connections: computed,
-      fileGenerations: computed,
-      generationSpecifications: computed,
-      sectionIndices: computed,
-    });
-
     this.extensionElementClasses = extensionElementClasses;
     this.buildState.setMessageFormatter(
       (message: string) => `[dependency] ${message}`,

package/src/graph/PureGraphExtension.ts

@@ -15,7 +15,6 @@
  */
 
 import type { Clazz } from '@finos/legend-shared';
-import { observable, computed, action, makeObservable } from 'mobx';
 import type { PackageableElement } from '../models/metamodels/pure/packageableElements/PackageableElement';
 
 export class PureGraphExtension<T extends PackageableElement> {
@@ -23,12 +22,6 @@ export class PureGraphExtension<T extends PackageableElement> {
   private readonly index = new Map<string, T>();
 
   constructor(_class: Clazz<T>) {
-    makeObservable<PureGraphExtension<T>, 'index'>(this, {
-      index: observable,
-      elements: computed,
-      setElement: action,
-      deleteElement: action,
-    });
     this._class = _class;
   }
 

package/src/graph/PureModel.ts

@@ -14,7 +14,6 @@
  * limitations under the License.
  */
 
-import { action, observable, makeObservable } from 'mobx';
 import {
   PRIMITIVE_TYPE,
   ROOT_PACKAGE_NAME,
@@ -187,14 +186,6 @@ export class PureModel extends BasicModel {
       (plugin) => plugin.getExtraPureGraphExtensionClasses?.() ?? [],
     );
     super(ROOT_PACKAGE_NAME.MAIN, extensionElementClasses);
-
-    makeObservable(this, {
-      generationModel: observable,
-      dependencyManager: observable,
-      setDependencyManager: action,
-      addElement: action,
-    });
-
     this.graphPlugins = graphPlugins;
     this.coreModel = coreModel;
     this.systemModel = systemModel;

package/src/graphManager/AbstractPureGraphManager.ts

@@ -50,7 +50,6 @@ import type {
 } from '../models/metamodels/pure/executionPlan/ExecutionPlan';
 import type { ExecutionNode } from '../models/metamodels/pure/executionPlan/nodes/ExecutionNode';
 import type {
-  GeneratorFn,
   Log,
   ServerClientConfig,
   TracerService,
@@ -77,8 +76,6 @@ export interface GraphBuilderOptions {
   TEMPORARY__keepSectionIndex?: boolean;
   // when we change our handling of section index, we should be able to get rid of this flag.
   TEMPORARY__disableRawLambdaResolver?: boolean;
-  // skip specific post processing used when editing graph. i.e `freezing` a generated/dependency element.
-  TEMPORARY_skipGraphBuilderPostProcessing?: boolean;
 }
 
 export interface ExecutionOptions {
@@ -114,7 +111,7 @@ export abstract class AbstractPureGraphManager {
     options?: {
       tracerService?: TracerService | undefined;
     },
-  ): GeneratorFn<void>;
+  ): Promise<void>;
 
   // --------------------------------------------- Graph Builder ---------------------------------------------
 
@@ -128,7 +125,7 @@ export abstract class AbstractPureGraphManager {
     coreModel: CoreModel,
     systemModel: SystemModel,
     options?: GraphBuilderOptions,
-  ): GeneratorFn<GraphBuilderReport>;
+  ): Promise<GraphBuilderReport>;
 
   /**
    * Process entities and build the main graph.
@@ -137,7 +134,7 @@ export abstract class AbstractPureGraphManager {
     graph: PureModel,
     entities: Entity[],
     options?: GraphBuilderOptions,
-  ): GeneratorFn<GraphBuilderReport>;
+  ): Promise<GraphBuilderReport>;
 
   /**
    * Build immutable models which holds dependencies.
@@ -153,13 +150,13 @@ export abstract class AbstractPureGraphManager {
     dependencyManager: DependencyManager,
     dependencyEntitiesMap: Map<string, Entity[]>,
     options?: GraphBuilderOptions,
-  ): GeneratorFn<GraphBuilderReport>;
+  ): Promise<GraphBuilderReport>;
 
   abstract buildGenerations(
     graph: PureModel,
     generationEntities: Map<string, Entity[]>,
     options?: GraphBuilderOptions,
-  ): GeneratorFn<GraphBuilderReport>;
+  ): Promise<GraphBuilderReport>;
 
   // ------------------------------------------- Grammar -------------------------------------------
 

package/src/graphManager/DSLExternalFormat_PureGraphManagerPlugin.ts

@@ -15,15 +15,25 @@
  */
 
 import packageJson from '../../package.json';
+import type { Connection } from '../DSLMapping_Exports';
 import { ExternalFormatConnection } from '../models/metamodels/pure/packageableElements/externalFormat/connection/DSLExternalFormat_ExternalFormatConnection';
 import { SchemaSet } from '../models/metamodels/pure/packageableElements/externalFormat/schemaSet/DSLExternalFormat_SchemaSet';
 import { Binding } from '../models/metamodels/pure/packageableElements/externalFormat/store/DSLExternalFormat_Binding';
+import type { PackageableElement } from '../models/metamodels/pure/packageableElements/PackageableElement';
+import type { ObserverContext } from './action/changeDetection/CoreObserverHelper';
+import {
+  observe_Binding,
+  observe_ExternalFormatConnection,
+  observe_SchemaSet,
+} from './action/changeDetection/DSLExternalFormat_ObserverHelper';
 import type {
+  ConnectionObserver,
   DSLMapping_PureGraphManagerPlugin_Extension,
   PureGrammarConnectionLabeler,
 } from './DSLMapping_PureGraphManagerPlugin_Extension';
 import {
   type PureGrammarElementLabeler,
+  type ElementObserver,
   PureGraphManagerPlugin,
 } from './PureGraphManagerPlugin';
 
@@ -73,6 +83,22 @@ export class DSLExternalFormat_PureGraphManagerPlugin
     ];
   }
 
+  override getExtraElementObservers(): ElementObserver[] {
+    return [
+      (
+        element: PackageableElement,
+        context: ObserverContext,
+      ): PackageableElement | undefined => {
+        if (element instanceof Binding) {
+          return observe_Binding(element);
+        } else if (element instanceof SchemaSet) {
+          return observe_SchemaSet(element);
+        }
+        return undefined;
+      },
+    ];
+  }
+
   getExtraPureGrammarConnectionLabelers(): PureGrammarConnectionLabeler[] {
     return [
       (connection): string | undefined => {
@@ -83,4 +109,18 @@ export class DSLExternalFormat_PureGraphManagerPlugin
       },
     ];
   }
+
+  getExtraConnectionObservers(): ConnectionObserver[] {
+    return [
+      (
+        connection: Connection,
+        context: ObserverContext,
+      ): Connection | undefined => {
+        if (connection instanceof ExternalFormatConnection) {
+          return observe_ExternalFormatConnection(connection);
+        }
+        return undefined;
+      },
+    ];
+  }
 }

package/src/graphManager/DSLMapping_PureGraphManagerPlugin_Extension.ts

@@ -15,11 +15,31 @@
  */
 
 import type { Connection } from '../models/metamodels/pure/packageableElements/connection/Connection';
+import type { InputData } from '../models/metamodels/pure/packageableElements/mapping/InputData';
+import type { PropertyMapping } from '../models/metamodels/pure/packageableElements/mapping/PropertyMapping';
+import type { SetImplementation } from '../models/metamodels/pure/packageableElements/mapping/SetImplementation';
+import type { ObserverContext } from './action/changeDetection/CoreObserverHelper';
 import type { PureGraphManagerPlugin } from './PureGraphManagerPlugin';
 
 export type PureGrammarConnectionLabeler = (
   connection: Connection,
 ) => string | undefined;
+export type ConnectionObserver = (
+  connection: Connection,
+  context: ObserverContext,
+) => Connection | undefined;
+export type SetImplementationObserver = (
+  setImplementation: SetImplementation,
+  context: ObserverContext,
+) => SetImplementation | undefined;
+export type PropertyMappingObserver = (
+  propertyMapping: PropertyMapping,
+  context: ObserverContext,
+) => PropertyMapping | undefined;
+export type MappingTestInputDataObserver = (
+  inputData: InputData,
+  context: ObserverContext,
+) => InputData | undefined;
 
 export interface DSLMapping_PureGraphManagerPlugin_Extension
   extends PureGraphManagerPlugin {
@@ -27,4 +47,12 @@ export interface DSLMapping_PureGraphManagerPlugin_Extension
    * Get the list of Pure grammar type labelers for connections.
    */
   getExtraPureGrammarConnectionLabelers?(): PureGrammarConnectionLabeler[];
+
+  getExtraSetImplementationObservers?(): SetImplementationObserver[];
+
+  getExtraMappingTestInputDataObservers?(): MappingTestInputDataObserver[];
+
+  getExtraPropertyMappingObservers?(): PropertyMappingObserver[];
+
+  getExtraConnectionObservers?(): ConnectionObserver[];
 }

package/src/graphManager/GraphManagerEvent.ts

@@ -24,7 +24,6 @@ export enum GRAPH_MANAGER_EVENT {
   GRAPH_BUILDER_CONNECTIONS_AND_RUNTIMES_BUILT = 'GRAPH_BUILDER_CONNECTIONS_AND_RUNTIMES_BUILT',
   GRAPH_BUILDER_SERVICES_BUILT = 'GRAPH_BUILDER_SERVICES_BUILT',
   GRAPH_BUILDER_OTHER_ELEMENTS_BUILT = 'GRAPH_BUILDER_OTHER_ELEMENTS_BUILT',
-  GRAPH_BUILDER_POST_PROCESSED = 'GRAPH_BUILDER_POST_PROCESSED',
   GRAPH_BUILDER_COMPLETED = 'GRAPH_BUILDER_COMPLETED',
 
   GRAPH_INITIALIZED = 'GRAPH_INITIALIZED',
@@ -36,7 +35,6 @@ export enum GRAPH_MANAGER_EVENT {
   GRAPH_META_MODEL_TO_PROTOCOL_TRANSFORMED = 'GRAPH_META_MODEL_TO_PROTOCOL_TRANSFORMED',
   GRAPH_COMPILE_CONTEXT_COLLECTED = 'GRAPH_COMPILE_CONTEXT_COLLECTED',
   GRAPH_PROTOCOL_SERIALIZED = 'GRAPH_PROTOCOL_SERIALIZED',
-  GRAPH_HASHES_PRECOMPUTED = 'GRAPH_HASHES_PRECOMPUTED',
 
   GRAPH_BUILDER_FAILURE = 'GRAPH_BUILD_FAILURE',
   EXECUTION_FAILURE = 'EXECUTION_FAILURE',

package/src/graphManager/PureGraphManagerPlugin.ts

@@ -17,6 +17,7 @@
 import { AbstractPlugin } from '@finos/legend-shared';
 import type { GraphPluginManager } from '../GraphPluginManager';
 import type { PackageableElement } from '../models/metamodels/pure/packageableElements/PackageableElement';
+import type { ObserverContext } from './action/changeDetection/CoreObserverHelper';
 
 /**
  * Unlike `PureGraphPlugin`, this is for plugins of graph manager, i.e. operations acting
@@ -27,6 +28,11 @@ export type PureGrammarElementLabeler = (
   metamodel: PackageableElement,
 ) => string | undefined;
 
+export type ElementObserver = (
+  metamodel: PackageableElement,
+  context: ObserverContext,
+) => PackageableElement | undefined;
+
 export abstract class PureGraphManagerPlugin extends AbstractPlugin {
   private readonly _$nominalTypeBrand!: 'PureGraphManagerPlugin';
 
@@ -58,4 +64,10 @@ export abstract class PureGraphManagerPlugin extends AbstractPlugin {
    * able to see directly in selection/dropdown menus.
    */
   getExtraExposedSystemElementPath?(): string[];
+
+  /**
+   * Get the list of observers for packageable element. These observer will make the element
+   * become observable by change detection engine.
+   */
+  getExtraElementObservers?(): ElementObserver[];
 }

package/src/graphManager/StoreRelational_PureGraphManagerPlugin_Extension.ts

@@ -0,0 +1,50 @@
+/**
+ * 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 type { AuthenticationStrategy } from '../models/metamodels/pure/packageableElements/store/relational/connection/AuthenticationStrategy';
+import type { DatasourceSpecification } from '../models/metamodels/pure/packageableElements/store/relational/connection/DatasourceSpecification';
+import type { PostProcessor } from '../models/metamodels/pure/packageableElements/store/relational/connection/postprocessor/PostProcessor';
+import type { Milestoning } from '../models/metamodels/pure/packageableElements/store/relational/model/milestoning/Milestoning';
+import type { ObserverContext } from './action/changeDetection/CoreObserverHelper';
+import type { PureGraphManagerPlugin } from './PureGraphManagerPlugin';
+
+export type MilestoningObserver = (
+  milestoning: Milestoning,
+  context: ObserverContext,
+) => Milestoning | undefined;
+export type DatasourceSpecificationObserver = (
+  dataSourceSpec: DatasourceSpecification,
+  context: ObserverContext,
+) => DatasourceSpecification | undefined;
+export type AuthenticationStrategyObserver = (
+  authStrategy: AuthenticationStrategy,
+  context: ObserverContext,
+) => AuthenticationStrategy | undefined;
+export type PostProcessorObserver = (
+  postProcessor: PostProcessor,
+  context: ObserverContext,
+) => PostProcessor | undefined;
+
+export interface StoreRelational_PureGraphManagerPlugin_Extension
+  extends PureGraphManagerPlugin {
+  getExtraMilestoningObservers?(): MilestoningObserver[];
+
+  getExtraDatasourceSpecificationObservers?(): DatasourceSpecificationObserver[];
+
+  getExtraAuthenticationStrategyObservers?(): AuthenticationStrategyObserver[];
+
+  getExtraPostProcessorObservers?(): PostProcessorObserver[];
+}