@api-client/core 0.14.10 → 0.15.0

package/build/src/modeling/DomainImpactAnalysis.js

@@ -1,7 +1,4 @@
-import { DomainNamespaceKind, DomainEntityKind, DomainModelKind, DomainPropertyKind, DomainAssociationKind, DataDomainKind, } from '../models/kinds.js';
-import { AssociationValidation } from './validation/association_validation.js';
-import { EntityValidation } from './validation/entity_validation.js';
-import { PropertyValidation } from './validation/property_validation.js';
+import { DomainNamespaceKind, DomainEntityKind, DomainModelKind, DomainPropertyKind, DomainAssociationKind, } from '../models/kinds.js';
 /**
  * # DomainImpactAnalysis
  *
@@ -23,13 +20,13 @@ import { PropertyValidation } from './validation/property_validation.js';
  *     -   `kind`: The kind of the impacted object.
  *     -   `type`: The type of impact (currently only `delete`).
  *     -   `impact`: A human-readable description of the impact.
- *     -   `blocking`: Whether this impact prevents the deletion from proceeding.
  *     -   `relationship`: The type of relationship between the deleted object and the impacted object (e.g., `child`).
  *     -   `resolution`: A description of how the impact will be resolved if the deletion is forced.
+ *     -   `severity`: The severity of the impact, which can be `info`, `warning`, or `error`.
  *
  * -   **Blocking Impacts:** Some impacts are considered "blocking," meaning they prevent the deletion from proceeding
  *     without manual intervention. For example, deleting an entity that is a parent to other entities is
- *     a blocking impact.
+ *     a blocking impact. Blocking impacts are indicated by the `severity` property set to `error`.
  *
  * -   **Non-Blocking Impacts:** Some impacts are informational and do not prevent the deletion. For example, deleting a
  *     property is not a blocking impact.
@@ -61,7 +58,7 @@ import { PropertyValidation } from './validation/property_validation.js';
  * 3.  **Interpreting the Report:** Examine the `DomainImpactReport` to understand the consequences of the deletion.
  *     -   Check `report.canProceed` to see if the deletion is safe.
  *     -   Iterate through `report.impact` to understand each consequence.
- *     -   Pay special attention to `impact.blocking` to identify impacts that require manual resolution.
+ *     -   Pay special attention to `impact.severity` to identify impacts that require manual resolution.
  *
  *     ```typescript
  *     if (report.canProceed) {
@@ -70,7 +67,7 @@ import { PropertyValidation } from './validation/property_validation.js';
  *       console.warn('Deletion cannot proceed due to the following impacts:');
  *       report.impact.forEach((item) => {
  *         console.warn(`- ${item.impact}`);
- *         if (item.blocking) {
+ *         if (item.severity === 'error') {
  *           console.warn(`  - This impact is blocking.`);
  *           if (item.resolution) {
  *             console.warn(`  - Resolution: ${item.resolution}`);
@@ -122,7 +119,7 @@ import { PropertyValidation } from './validation/property_validation.js';
  *       "kind": "DomainEntityKind",
  *       "type": "delete",
  *       "impact": "The entity with key Product will be deleted.",
- *       "blocking": false
+ *       "severity": "warning"
  *     },
  *     {
  *       "key": "SpecialProduct",
@@ -130,7 +127,7 @@ import { PropertyValidation } from './validation/property_validation.js';
  *       "type": "delete",
  *       "impact": "The SpecialProduct entity will become an orphan because it is a child of Product.",
  *       "resolution": "The \"Product\" entity will be removed as the parent of the \"SpecialProduct\" entity.",
- *       "blocking": true,
+ *       "severity": "error",
  *       "relationship": "child"
  *     },
  *     {
@@ -139,14 +136,14 @@ import { PropertyValidation } from './validation/property_validation.js';
  *       "type": "delete",
  *       "impact": "The association with key category will be broken because it has a target to Product.",
  *       "resolution": "The association with key category will be removed from Product.",
- *       "blocking": true
+ *       "severity": "error"
  *     },
  *     {
  *       "key": "name",
  *       "kind": "DomainPropertyKind",
  *       "type": "delete",
  *       "impact": "The property with key name will be deleted.",
- *       "blocking": false
+ *       "severity": "info"
  *     }
  *   ],
  *   "canProceed": false
@@ -174,27 +171,6 @@ import { PropertyValidation } from './validation/property_validation.js';
  *     - `DomainAssociationKind`
  *     - `DataDomainKind`
  *
- * ### `DomainImpactReport`
- *
- * -   **Description:** The structure of the impact analysis report.
- * -   **Properties:**
- *     -   `key` (`string`): The key of the object being deleted.
- *     -   `kind` (`DomainImpactKinds`): The kind of the object being deleted.
- *     -   `impact` (`DomainImpactItem[]`): The list of impacts.
- *     -   `canProceed` (`boolean`): Whether the deletion can proceed.
- *
- * ### `DomainImpactItem`
- *
- * -   **Description:** The structure of an individual impact item.
- * -   **Properties:**
- *     -   `key` (`string`): The key of the impacted object.
- *     -   `kind` (`string`): The kind of the impacted object.
- *     -   `type` (`'delete'`): The type of impact.
- *     -   `impact` (`string`): The impact description.
- *     -   `blocking` (`boolean`): Whether the impact is blocking.
- *     -   `relationship` (`'child'`, optional): The relationship type.
- *     -   `resolution` (`string`, optional): The resolution description.
- *
  * ## Error Handling
  *
  * The `DomainImpactAnalysis` class does not throw errors. Instead, it uses the `DomainImpactReport` to communicate
@@ -204,7 +180,7 @@ import { PropertyValidation } from './validation/property_validation.js';
  *
  * - **Always Analyze Before Deleting:** Before deleting any data domain element, always use `DomainImpactAnalysis`
  *   to understand the consequences.
- * - **Handle Blocking Impacts:** Pay close attention to `blocking` impacts and implement appropriate
+ * - **Handle Blocking Impacts:** Pay close attention to `severity = "error"` impacts and implement appropriate
  *   logic to handle them.
  * - **Inform the User:** If a deletion cannot proceed, inform the user about the blocking impacts and provide
  *   guidance on how to resolve them.
@@ -218,16 +194,9 @@ import { PropertyValidation } from './validation/property_validation.js';
  * about data deletion and prevent unintended consequences.
  */
 export class DomainImpactAnalysis {
-    report;
     root;
     constructor(root) {
         this.root = root;
-        this.report = {
-            key: '',
-            kind: DataDomainKind,
-            impact: [],
-            canProceed: false,
-        };
     }
     /**
      * Generates a report of how the data domain will be impacted by the deletion of a data domain object.
@@ -236,14 +205,15 @@ export class DomainImpactAnalysis {
      * @returns The delete impact analysis report.
      */
     deleteAnalysis(key, kind) {
-        this.report = {
+        const report = {
             key,
             kind,
             impact: [],
             canProceed: true,
         };
-        this.createDeleteImpact(key, kind, key);
-        return this.report;
+        this.createDeleteImpact(key, kind, key, report.impact);
+        report.canProceed = this.computeCanProceed(report.impact);
+        return report;
     }
     /**
      * Generates a report of how the data domain will be impacted by the removal of a foreign namespace.
@@ -251,156 +221,90 @@ export class DomainImpactAnalysis {
      * @returns The delete impact analysis report.
      */
     removeForeignNamespaceAnalysis(key) {
-        this.report = {
+        const report = {
             key,
             kind: DomainNamespaceKind,
             impact: [],
             canProceed: true,
         };
-        this.createRemoveForeignNamespaceImpact(key);
-        return this.report;
+        this.createRemoveForeignNamespaceImpact(key, report.impact);
+        report.canProceed = this.computeCanProceed(report.impact);
+        return report;
     }
     /**
-     * Analyzes the data domain for publishing. Essentially, it performs a validation of the data domain
-     * and returns a report of the impact.
-     * @returns The publish impact analysis report.
+     * Computes whether the deletion can proceed based on the impact report.
+     * @param impact The list of impacts from the analysis.
+     * @returns `true` if the deletion can proceed, `false` otherwise.
      */
-    publishAnalysis() {
-        this.report = {
-            key: '',
-            kind: DataDomainKind,
-            impact: [],
-            canProceed: true,
-        };
-        const entityValidator = new EntityValidation(this.root);
-        const propertyValidator = new PropertyValidation(this.root);
-        const associationValidator = new AssociationValidation(this.root);
-        for (const entity of this.root.listEntities()) {
-            if (entity.domain.key !== this.root.key) {
-                // we don't need to validate foreign entities
-                continue;
-            }
-            const report = entityValidator.validate(entity);
-            for (const item of report) {
-                const blocking = item.severity === 'error';
-                this.report.canProceed = this.report.canProceed && !blocking;
-                this.report.impact.push({
-                    key: item.key,
-                    kind: item.kind,
-                    type: 'publish',
-                    impact: item.message,
-                    blocking,
-                    resolution: item.help,
-                    severity: item.severity,
-                    parent: item.parent,
-                });
-            }
-            for (const property of entity.properties) {
-                const report = propertyValidator.validate(property);
-                for (const item of report) {
-                    const blocking = item.severity === 'error';
-                    this.report.canProceed = this.report.canProceed && !blocking;
-                    this.report.impact.push({
-                        key: item.key,
-                        kind: item.kind,
-                        type: 'publish',
-                        impact: item.message,
-                        blocking,
-                        resolution: item.help,
-                        severity: item.severity,
-                        parent: item.parent,
-                    });
-                }
-            }
-            for (const association of entity.associations) {
-                const report = associationValidator.validate(association);
-                for (const item of report) {
-                    const blocking = item.severity === 'error';
-                    this.report.canProceed = this.report.canProceed && !blocking;
-                    this.report.impact.push({
-                        key: item.key,
-                        kind: item.kind,
-                        type: 'publish',
-                        impact: item.message,
-                        blocking,
-                        resolution: item.help,
-                        severity: item.severity,
-                        parent: item.parent,
-                    });
-                }
-            }
-        }
-        return this.report;
+    computeCanProceed(impact) {
+        return !impact.some((item) => item.severity === 'error');
     }
-    createDeleteImpact(key, kind, rootKey) {
+    createDeleteImpact(key, kind, rootKey, impact) {
         switch (kind) {
             case DomainNamespaceKind:
-                this.deleteNamespaceAnalysis(key, rootKey);
+                this.deleteNamespaceAnalysis(key, rootKey, impact);
                 break;
             case DomainModelKind:
-                this.deleteModelAnalysis(key, rootKey);
+                this.deleteModelAnalysis(key, rootKey, impact);
                 break;
             case DomainEntityKind:
-                this.deleteEntityAnalysis(key, rootKey);
+                this.deleteEntityAnalysis(key, rootKey, impact);
                 break;
             case DomainPropertyKind:
-                this.deletePropertyAnalysis(key);
+                this.deletePropertyAnalysis(key, impact);
                 break;
             case DomainAssociationKind:
-                this.deleteAssociationAnalysis(key);
+                this.deleteAssociationAnalysis(key, impact);
                 break;
             default:
             // ignore unknown kinds
         }
     }
-    deleteNamespaceAnalysis(key, rootKey) {
+    deleteNamespaceAnalysis(key, rootKey, impact) {
         const ns = this.root.findNamespace(key);
         if (!ns) {
             return;
         }
-        this.report.impact.push({
+        impact.push({
             key: ns.key,
             kind: ns.kind,
             type: 'delete',
             impact: `The ${ns.info.getLabel()} ${this.kindToLabel(DomainNamespaceKind)} will be deleted.`,
-            blocking: false,
             severity: 'info',
         });
         for (const child of ns.listNamespaces()) {
-            this.deleteNamespaceAnalysis(child.key, rootKey);
+            this.deleteNamespaceAnalysis(child.key, rootKey, impact);
         }
         for (const child of ns.listModels()) {
-            this.deleteModelAnalysis(child.key, rootKey);
+            this.deleteModelAnalysis(child.key, rootKey, impact);
         }
     }
-    deleteModelAnalysis(key, rootKey) {
+    deleteModelAnalysis(key, rootKey, impact) {
         const model = this.root.findModel(key);
         if (!model) {
             return;
         }
-        this.report.impact.push({
+        impact.push({
             key: model.key,
             kind: model.kind,
             type: 'delete',
             impact: `The ${model.info.getLabel()} ${this.kindToLabel(DomainModelKind)} will be deleted.`,
-            blocking: false,
             severity: 'info',
         });
         for (const child of model.listEntities()) {
-            this.deleteEntityAnalysis(child.key, rootKey);
+            this.deleteEntityAnalysis(child.key, rootKey, impact);
         }
     }
-    deleteEntityAnalysis(key, rootKey) {
+    deleteEntityAnalysis(key, rootKey, impact) {
         const entity = this.root.findEntity(key);
         if (!entity) {
             return;
         }
-        this.report.impact.push({
+        impact.push({
             key: entity.key,
             kind: entity.kind,
             type: 'delete',
             impact: `The ${entity.info.getLabel()} ${this.kindToLabel(DomainEntityKind)} will be deleted.`,
-            blocking: false,
             severity: 'info',
         });
         // We need to know whether the entity is a parent of another entity
@@ -419,17 +323,15 @@ export class DomainImpactAnalysis {
             }
             const pLabel = entity.info.getLabel();
             const cLabel = childEntity.info.getLabel();
-            this.report.impact.push({
+            impact.push({
                 key: childEntity.key,
                 kind: childEntity.kind,
                 type: 'delete',
                 impact: `The "${cLabel}" ${this.kindToLabel(DomainEntityKind)} will become an orphan because it is a child of the "${pLabel}" entity.`,
                 resolution: `The "${pLabel}" entity will be removed as the parent of the "${cLabel}" entity.`,
-                blocking: false,
                 relationship: 'child',
                 severity: 'error',
             });
-            this.report.canProceed = false;
         }
         // We need to know whether there's another entity that has an association to this entity.
         for (const edgeInfo of this.root.graph.inEdges(entity.key)) {
@@ -451,49 +353,45 @@ export class DomainImpactAnalysis {
             }
             const aLabel = association.info.getLabel();
             const eLabel = entity.info.getLabel();
-            this.report.impact.push({
+            impact.push({
                 key: association.key,
                 kind: association.kind,
                 type: 'delete',
                 impact: `The ${aLabel} ${this.kindToLabel(DomainAssociationKind)} will be broken because it has a target to ${eLabel}.`,
                 resolution: `The ${aLabel} ${this.kindToLabel(DomainAssociationKind)} will be removed from ${eLabel}.`,
-                blocking: true,
                 severity: 'error',
             });
-            this.report.canProceed = false;
         }
         for (const child of entity.listProperties()) {
-            this.deletePropertyAnalysis(child.key);
+            this.deletePropertyAnalysis(child.key, impact);
         }
         for (const child of entity.listAssociations()) {
-            this.deleteAssociationAnalysis(child.key);
+            this.deleteAssociationAnalysis(child.key, impact);
         }
     }
-    deletePropertyAnalysis(key) {
+    deletePropertyAnalysis(key, impact) {
         const property = this.root.findProperty(key);
         if (!property) {
             return;
         }
-        this.report.impact.push({
+        impact.push({
             key: property.key,
             kind: property.kind,
             type: 'delete',
             impact: `The ${property.info.getLabel()} ${this.kindToLabel(DomainPropertyKind)} will be deleted.`,
-            blocking: false,
             severity: 'info',
         });
     }
-    deleteAssociationAnalysis(key) {
+    deleteAssociationAnalysis(key, impact) {
         const association = this.root.findAssociation(key);
         if (!association) {
             return;
         }
-        this.report.impact.push({
+        impact.push({
             key: association.key,
             kind: association.kind,
             type: 'delete',
             impact: `The ${association.info.getLabel()} ${this.kindToLabel(DomainAssociationKind)} will be deleted.`,
-            blocking: false,
             severity: 'info',
         });
     }
@@ -513,7 +411,7 @@ export class DomainImpactAnalysis {
                 return 'unknown';
         }
     }
-    createRemoveForeignNamespaceImpact(key) {
+    createRemoveForeignNamespaceImpact(key, impact) {
         const foreignNamespace = this.root.dependencies.get(key);
         if (!foreignNamespace) {
             return;
@@ -533,17 +431,15 @@ export class DomainImpactAnalysis {
                     }
                     const eLabel = entity.info.getLabel();
                     const pLabel = parentEntity.info.getLabel();
-                    this.report.impact.push({
+                    impact.push({
                         key: entity.key,
                         kind: entity.kind,
                         type: 'delete',
                         impact: `The "${eLabel}" ${this.kindToLabel(DomainEntityKind)} will become an orphan because its parent "${pLabel}" is in the foreign namespace "${foreignNamespace.key}".`,
                         resolution: `The "${pLabel}" entity will be removed as the parent of the "${eLabel}" entity.`,
-                        blocking: true,
                         relationship: 'child',
                         severity: 'error',
                     });
-                    this.report.canProceed = false;
                 }
                 else if (edge.type === 'association') {
                     const association = this.root.findAssociation(info.w);
@@ -560,16 +456,14 @@ export class DomainImpactAnalysis {
                             const aLabel = association.info.getLabel();
                             const eLabel = entity.info.getLabel();
                             const tLabel = targetEntity.info.getLabel();
-                            this.report.impact.push({
+                            impact.push({
                                 key: association.key,
                                 kind: association.kind,
                                 type: 'delete',
                                 impact: `The "${aLabel}" ${this.kindToLabel(DomainAssociationKind)} from "${eLabel}" will be broken because it targets "${tLabel}" in the foreign namespace "${foreignNamespace.key}".`,
                                 resolution: `The "${aLabel}" ${this.kindToLabel(DomainAssociationKind)} will be removed from "${eLabel}".`,
-                                blocking: true,
                                 severity: 'error',
                             });
-                            this.report.canProceed = false;
                         }
                     }
                 }

package/build/src/modeling/DomainImpactAnalysis.js.map

@@ -1 +1 @@
-{"version":3,"file":"DomainImpactAnalysis.js","sourceRoot":"","sources":["../../../src/modeling/DomainImpactAnalysis.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,cAAc,GACf,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAA;AAC9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAA;AAsFxE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsNG;AACH,MAAM,OAAO,oBAAoB;IACvB,MAAM,CAAoB;IAC1B,IAAI,CAAY;IAExB,YAAY,IAAgB;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,EAAE,EAAE;YACP,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,KAAK;SAClB,CAAA;IACH,CAAC;IAED;;;;;OAKG;IACH,cAAc,CAAC,GAAW,EAAE,IAAuB;QACjD,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG;YACH,IAAI;YACJ,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,IAAI;SACjB,CAAA;QACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;QACvC,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED;;;;OAIG;IACH,8BAA8B,CAAC,GAAW;QACxC,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG;YACH,IAAI,EAAE,mBAAmB;YACzB,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,IAAI;SACjB,CAAA;QACD,IAAI,CAAC,kCAAkC,CAAC,GAAG,CAAC,CAAA;QAC5C,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,IAAI,CAAC,MAAM,GAAG;YACZ,GAAG,EAAE,EAAE;YACP,IAAI,EAAE,cAAc;YACpB,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,IAAI;SACjB,CAAA;QACD,MAAM,eAAe,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvD,MAAM,iBAAiB,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC3D,MAAM,oBAAoB,GAAG,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjE,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YAC9C,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;gBACxC,6CAA6C;gBAC7C,SAAQ;YACV,CAAC;YACD,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAC/C,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;gBAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAA;gBAC1C,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAA;gBAC5D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;oBACtB,GAAG,EAAE,IAAI,CAAC,GAAG;oBACb,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,IAAI,CAAC,OAAO;oBACpB,QAAQ;oBACR,UAAU,EAAE,IAAI,CAAC,IAAI;oBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAA;YACJ,CAAC;YACD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACzC,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;gBACnD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAA;oBAC1C,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAA;oBAC5D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;wBACtB,GAAG,EAAE,IAAI,CAAC,GAAG;wBACb,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE,IAAI,CAAC,OAAO;wBACpB,QAAQ;wBACR,UAAU,EAAE,IAAI,CAAC,IAAI;wBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;qBACpB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;YACD,KAAK,MAAM,WAAW,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBAC9C,MAAM,MAAM,GAAG,oBAAoB,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAA;gBACzD,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;oBAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,OAAO,CAAA;oBAC1C,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,QAAQ,CAAA;oBAC5D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;wBACtB,GAAG,EAAE,IAAI,CAAC,GAAG;wBACb,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE,IAAI,CAAC,OAAO;wBACpB,QAAQ;wBACR,UAAU,EAAE,IAAI,CAAC,IAAI;wBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;wBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;qBACpB,CAAC,CAAA;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAES,kBAAkB,CAAC,GAAW,EAAE,IAAuB,EAAE,OAAe;QAChF,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,mBAAmB;gBACtB,IAAI,CAAC,uBAAuB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;gBAC1C,MAAK;YACP,KAAK,eAAe;gBAClB,IAAI,CAAC,mBAAmB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;gBACtC,MAAK;YACP,KAAK,gBAAgB;gBACnB,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;gBACvC,MAAK;YACP,KAAK,kBAAkB;gBACrB,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAA;gBAChC,MAAK;YACP,KAAK,qBAAqB;gBACxB,IAAI,CAAC,yBAAyB,CAAC,GAAG,CAAC,CAAA;gBACnC,MAAK;YACP,QAAQ;YACR,uBAAuB;QACzB,CAAC;IACH,CAAC;IAES,uBAAuB,CAAC,GAAW,EAAE,OAAe;QAC5D,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;QACvC,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACtB,GAAG,EAAE,EAAE,CAAC,GAAG;YACX,IAAI,EAAE,EAAE,CAAC,IAAI;YACb,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,mBAAmB;YAC7F,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAA;QACF,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC;YACxC,IAAI,CAAC,uBAAuB,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAClD,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC;YACpC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC;IAES,mBAAmB,CAAC,GAAW,EAAE,OAAe;QACxD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACtB,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,eAAe,CAAC,mBAAmB;YAC5F,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAA;QACF,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,YAAY,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;QAC/C,CAAC;IACH,CAAC;IAES,oBAAoB,CAAC,GAAW,EAAE,OAAe;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAA;QACxC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACtB,GAAG,EAAE,MAAM,CAAC,GAAG;YACf,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,mBAAmB;YAC9F,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAA;QAEF,mEAAmE;QACnE,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACvC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,SAAQ;YACV,CAAC;YACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAChD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,SAAQ;YACV,CAAC;YACD,IAAI,WAAW,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,8DAA8D;gBAC9D,SAAQ;YACV,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YACrC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC1C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACtB,GAAG,EAAE,WAAW,CAAC,GAAG;gBACpB,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,QAAQ,MAAM,KAAK,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,wDAAwD,MAAM,WAAW;gBACtI,UAAU,EAAE,QAAQ,MAAM,kDAAkD,MAAM,WAAW;gBAC7F,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,OAAO;gBACrB,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAA;YACF,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAA;QAChC,CAAC;QACD,yFAAyF;QACzF,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC3C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACzC,SAAQ;YACV,CAAC;YACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YACzD,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,SAAQ;YACV,CAAC;YACD,MAAM,YAAY,GAAG,WAAW,CAAC,iBAAiB,EAAE,CAAA;YACpD,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,SAAQ;YACV,CAAC;YACD,IAAI,YAAY,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;gBACpC,mFAAmF;gBACnF,SAAQ;YACV,CAAC;YAED,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;YACrC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACtB,GAAG,EAAE,WAAW,CAAC,GAAG;gBACpB,IAAI,EAAE,WAAW,CAAC,IAAI;gBACtB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,OAAO,MAAM,IAAI,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,8CAA8C,MAAM,GAAG;gBACvH,UAAU,EAAE,OAAO,MAAM,IAAI,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,yBAAyB,MAAM,GAAG;gBACtG,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,OAAO;aAClB,CAAC,CAAA;YACF,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAA;QAChC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;YAC5C,IAAI,CAAC,sBAAsB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACxC,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAC9C,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QAC3C,CAAC;IACH,CAAC;IAES,sBAAsB,CAAC,GAAW;QAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAA;QAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACtB,GAAG,EAAE,QAAQ,CAAC,GAAG;YACjB,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,mBAAmB;YAClG,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAA;IACJ,CAAC;IAES,yBAAyB,CAAC,GAAW;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,CAAA;QAClD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAM;QACR,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YACtB,GAAG,EAAE,WAAW,CAAC,GAAG;YACpB,IAAI,EAAE,WAAW,CAAC,IAAI;YACtB,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,mBAAmB;YACxG,QAAQ,EAAE,KAAK;YACf,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAA;IACJ,CAAC;IAES,WAAW,CAAC,IAAuB;QAC3C,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,mBAAmB;gBACtB,OAAO,WAAW,CAAA;YACpB,KAAK,gBAAgB;gBACnB,OAAO,QAAQ,CAAA;YACjB,KAAK,eAAe;gBAClB,OAAO,YAAY,CAAA;YACrB,KAAK,kBAAkB;gBACrB,OAAO,UAAU,CAAA;YACnB,KAAK,qBAAqB;gBACxB,OAAO,aAAa,CAAA;YACtB;gBACE,OAAO,SAAS,CAAA;QACpB,CAAC;IACH,CAAC;IAES,kCAAkC,CAAC,GAAW;QACtD,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACxD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,OAAM;QACR,CAAC;QACD,qDAAqD;QACrD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;YAC9C,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACvC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,SAAQ;gBACV,CAAC;gBACD,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;oBAClD,yCAAyC;oBACzC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;oBACjD,IAAI,CAAC,YAAY,EAAE,CAAC;wBAClB,SAAQ;oBACV,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;oBACrC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;oBAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;wBACtB,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,IAAI,EAAE,QAAQ;wBACd,MAAM,EAAE,QAAQ,MAAM,KAAK,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,8CAA8C,MAAM,kCAAkC,gBAAgB,CAAC,GAAG,IAAI;wBAC3K,UAAU,EAAE,QAAQ,MAAM,kDAAkD,MAAM,WAAW;wBAC7F,QAAQ,EAAE,IAAI;wBACd,YAAY,EAAE,OAAO;wBACrB,QAAQ,EAAE,OAAO;qBAClB,CAAC,CAAA;oBACF,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAA;gBAChC,CAAC;qBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;oBACvC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;oBACrD,IAAI,CAAC,WAAW,EAAE,CAAC;wBACjB,SAAQ;oBACV,CAAC;oBACD,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAA;oBACnE,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;wBACnB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;4BAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAgB,CAAC,CAAA;4BACjF,IAAI,CAAC,YAAY,EAAE,CAAC;gCAClB,SAAQ;4BACV,CAAC;4BACD,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;4BAC1C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;4BACrC,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAA;4BAC3C,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gCACtB,GAAG,EAAE,WAAW,CAAC,GAAG;gCACpB,IAAI,EAAE,WAAW,CAAC,IAAI;gCACtB,IAAI,EAAE,QAAQ;gCACd,MAAM,EAAE,QAAQ,MAAM,KAAK,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,UAAU,MAAM,wCAAwC,MAAM,+BAA+B,gBAAgB,CAAC,GAAG,IAAI;gCACvL,UAAU,EAAE,QAAQ,MAAM,KAAK,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAAC,0BAA0B,MAAM,IAAI;gCAC1G,QAAQ,EAAE,IAAI;gCACd,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAA;4BACF,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,KAAK,CAAA;wBAChC,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import {\n  DomainNamespaceKind,\n  DomainEntityKind,\n  DomainModelKind,\n  DomainPropertyKind,\n  DomainAssociationKind,\n  DataDomainKind,\n} from '../models/kinds.js'\nimport type { DataDomain } from './DataDomain.js'\nimport { AssociationValidation } from './validation/association_validation.js'\nimport { EntityValidation } from './validation/entity_validation.js'\nimport { PropertyValidation } from './validation/property_validation.js'\n\nexport type DomainImpactKinds =\n  | typeof DomainNamespaceKind\n  | typeof DomainEntityKind\n  | typeof DomainModelKind\n  | typeof DomainPropertyKind\n  | typeof DomainAssociationKind\n  | typeof DataDomainKind\n\n/**\n * The impact analysis report\n */\nexport interface DomainImpactReport {\n  /**\n   * The key of the impacted data object.\n   * This is the key of the object that is being changed.\n   */\n  key: string\n  /**\n   * The kind of the impacted data object.\n   * This is the kind of the object that is being changed.\n   */\n  kind: DomainImpactKinds\n  /**\n   * The list of impacted data objects.\n   */\n  impact: DomainImpactItem[]\n  /**\n   * Whether it is possible to proceed with the change.\n   * If the change is not possible, the reason will be in the impact list.\n   */\n  canProceed: boolean\n}\n\nexport interface DomainImpactItem {\n  /**\n   * The key of the impacted data object.\n   */\n  key: string\n  /**\n   * The kind of the impacted data object.\n   */\n  kind: string\n  /**\n   * The type of the impact.\n   *\n   * - `delete` - The data object would be deleted.\n   */\n  type: 'delete' | 'publish'\n  /**\n   * The impact description.\n   * Explains what will happen to the impacted data object.\n   * This is a human-readable description of the impact.\n   * It should be clear and concise.\n   */\n  impact: string\n  /**\n   * The severity of the impact.\n   *\n   * - `info` - The impact is informational.\n   * - `warning` - The impact can potentially cause problems but is not a blocker.\n   * - `error` - The impact is a blocker and needs to be resolved before proceeding.\n   */\n  severity: 'info' | 'warning' | 'error'\n  /**\n   * Whether the impact is blocking the operation.\n   * If true, the operation cannot proceed.\n   * @deprecated Use `severity` instead.\n   */\n  blocking: boolean\n  /**\n   * The type of the relationship between two impacted objects.\n   */\n  relationship?: 'child'\n  /**\n   * The resolution of the conflict if the change will be forced.\n   */\n  resolution?: string\n  /**\n   * The optional parent of the impacted data object.\n   * For example, if the impacted item is a property, this will be the entity it belongs to.\n   */\n  parent?: string\n}\n\n/**\n * # DomainImpactAnalysis\n *\n * The `DomainImpactAnalysis` class is a tool for analyzing the consequences of deleting data domain elements\n * within a `DataDomain`. It helps developers understand the ripple effects of removing a namespace, data model,\n * entity, property, or association, ensuring data integrity and preventing unintended side effects.\n *\n * ## Core Concepts\n *\n * -   **Impact Report:** The central output of the `DomainImpactAnalysis` class is an `DomainImpactReport`.\n *     This report details the potential consequences of a deletion operation, including:\n *     -   The object being deleted (`key`, `kind`).\n *     -   A list of `DomainImpactItem` objects, each describing a specific consequence.\n *     -   Whether the deletion can proceed safely (`canProceed`).\n *\n * -   **DomainImpactItem:** Each `DomainImpactItem` describes a specific consequence of the deletion.\n *     Key properties include:\n *     -   `key`: The key of the impacted object.\n *     -   `kind`: The kind of the impacted object.\n *     -   `type`: The type of impact (currently only `delete`).\n *     -   `impact`: A human-readable description of the impact.\n *     -   `blocking`: Whether this impact prevents the deletion from proceeding.\n *     -   `relationship`: The type of relationship between the deleted object and the impacted object (e.g., `child`).\n *     -   `resolution`: A description of how the impact will be resolved if the deletion is forced.\n *\n * -   **Blocking Impacts:** Some impacts are considered \"blocking,\" meaning they prevent the deletion from proceeding\n *     without manual intervention. For example, deleting an entity that is a parent to other entities is\n *     a blocking impact.\n *\n * -   **Non-Blocking Impacts:** Some impacts are informational and do not prevent the deletion. For example, deleting a\n *     property is not a blocking impact.\n *\n * ## Usage\n *\n * 1.  **Instantiation:** Create an instance of `DomainImpactAnalysis`, passing the root `DataDomain` as an argument.\n *\n *     ```typescript\n *     import { DataDomain } from './DataDomain';\n *     import { DomainImpactAnalysis } from './DomainImpactAnalysis';\n *\n *     const dataDomain = new DataDomain();\n *     // ... add some data to the domain\n *     const analyzer = new DomainImpactAnalysis(dataDomain);\n *     ```\n *\n * 2.  **Performing Analysis:** Use the `deleteAnalysis()` method to generate an `DomainImpactReport` for\n *     a specific deletion.\n *     Provide the `key` and `kind` of the object to be deleted.\n *\n *     ```typescript\n *     import { DomainEntityKind } from '../models/kinds.js';\n *     // ...\n *     const entityKey = 'some-entity-key';\n *     const report = analyzer.deleteAnalysis(entityKey, DomainEntityKind);\n *     ```\n *\n * 3.  **Interpreting the Report:** Examine the `DomainImpactReport` to understand the consequences of the deletion.\n *     -   Check `report.canProceed` to see if the deletion is safe.\n *     -   Iterate through `report.impact` to understand each consequence.\n *     -   Pay special attention to `impact.blocking` to identify impacts that require manual resolution.\n *\n *     ```typescript\n *     if (report.canProceed) {\n *       // Proceed with deletion\n *     } else {\n *       console.warn('Deletion cannot proceed due to the following impacts:');\n *       report.impact.forEach((item) => {\n *         console.warn(`- ${item.impact}`);\n *         if (item.blocking) {\n *           console.warn(`  - This impact is blocking.`);\n *           if (item.resolution) {\n *             console.warn(`  - Resolution: ${item.resolution}`);\n *           }\n *         }\n *       });\n *       // Handle blocking impacts (e.g., prompt the user, modify the data, etc.)\n *     }\n *     ```\n *\n * ## Supported Deletion Scenarios\n *\n * The `DomainImpactAnalysis` class supports analyzing the deletion of the following data domain element types:\n *\n * - **Namespaces (`DomainNamespaceKind`):** Deleting a namespace also impacts all its child namespaces,\n *   data models, entities, properties, and associations.\n * - **Data Models (`DomainModelKind`):** Deleting a data model impacts all its entities, properties, and associations.\n * - **Entities (`DomainEntityKind`):** Deleting an entity impacts its properties, associations, and any other\n *   entities that have it as a parent or target in an association.\n * - **Properties (`DomainPropertyKind`):** Deleting a property impacts the entity it belongs to.\n * - **Associations (`DomainAssociationKind`):** Deleting an association impacts the entity it belongs to.\n * - **Data Domain (`DataDomainKind`):** Deleting a data domain is not supported.\n *\n * ## Example: Deleting an Entity\n *\n * Consider the following scenario:\n *\n * ```\n * DataDomain\n *   - Namespace: `MyNamespace`\n *     -   Data Model: `ProductModel`\n *         -   Entity: `Product`\n *             -   Property: `name`\n *             -   Association: `category` (targets `Category` entity)\n *         -   Entity: `Category`\n *             - Property: `name`\n *         - Entity: `SpecialProduct` (parent: `Product`)\n * ```\n *\n * If you attempt to delete the `Product` entity, the `DomainImpactAnalysis` will generate a report similar to this:\n *\n * ```json\n * {\n *   \"key\": \"Product\",\n *   \"kind\": \"DomainEntityKind\",\n *   \"impact\": [\n *     {\n *       \"key\": \"Product\",\n *       \"kind\": \"DomainEntityKind\",\n *       \"type\": \"delete\",\n *       \"impact\": \"The entity with key Product will be deleted.\",\n *       \"blocking\": false\n *     },\n *     {\n *       \"key\": \"SpecialProduct\",\n *       \"kind\": \"DomainEntityKind\",\n *       \"type\": \"delete\",\n *       \"impact\": \"The SpecialProduct entity will become an orphan because it is a child of Product.\",\n *       \"resolution\": \"The \\\"Product\\\" entity will be removed as the parent of the \\\"SpecialProduct\\\" entity.\",\n *       \"blocking\": true,\n *       \"relationship\": \"child\"\n *     },\n *     {\n *       \"key\": \"category\",\n *       \"kind\": \"DomainAssociationKind\",\n *       \"type\": \"delete\",\n *       \"impact\": \"The association with key category will be broken because it has a target to Product.\",\n *       \"resolution\": \"The association with key category will be removed from Product.\",\n *       \"blocking\": true\n *     },\n *     {\n *       \"key\": \"name\",\n *       \"kind\": \"DomainPropertyKind\",\n *       \"type\": \"delete\",\n *       \"impact\": \"The property with key name will be deleted.\",\n *       \"blocking\": false\n *     }\n *   ],\n *   \"canProceed\": false\n * }\n * ```\n *\n * This report indicates that:\n *\n * -   The `Product` entity will be deleted.\n * -   The `SpecialProduct` entity will become an orphan (blocking).\n * -   The `category` association will be broken (blocking).\n * -   The `name` property will be deleted.\n * -   The deletion cannot proceed without addressing the blocking impacts.\n *\n * ## Types\n *\n * ### `DomainImpactKinds`\n *\n * -   **Description:** A type alias for the kinds of data domain elements that can be analyzed.\n * -   **Values:**\n *     - `DomainNamespaceKind`\n *     - `DomainEntityKind`\n *     - `DomainModelKind`\n *     - `DomainPropertyKind`\n *     - `DomainAssociationKind`\n *     - `DataDomainKind`\n *\n * ### `DomainImpactReport`\n *\n * -   **Description:** The structure of the impact analysis report.\n * -   **Properties:**\n *     -   `key` (`string`): The key of the object being deleted.\n *     -   `kind` (`DomainImpactKinds`): The kind of the object being deleted.\n *     -   `impact` (`DomainImpactItem[]`): The list of impacts.\n *     -   `canProceed` (`boolean`): Whether the deletion can proceed.\n *\n * ### `DomainImpactItem`\n *\n * -   **Description:** The structure of an individual impact item.\n * -   **Properties:**\n *     -   `key` (`string`): The key of the impacted object.\n *     -   `kind` (`string`): The kind of the impacted object.\n *     -   `type` (`'delete'`): The type of impact.\n *     -   `impact` (`string`): The impact description.\n *     -   `blocking` (`boolean`): Whether the impact is blocking.\n *     -   `relationship` (`'child'`, optional): The relationship type.\n *     -   `resolution` (`string`, optional): The resolution description.\n *\n * ## Error Handling\n *\n * The `DomainImpactAnalysis` class does not throw errors. Instead, it uses the `DomainImpactReport` to communicate\n * the results of the analysis, including any blocking impacts.\n *\n * ## Best Practices\n *\n * - **Always Analyze Before Deleting:** Before deleting any data domain element, always use `DomainImpactAnalysis`\n *   to understand the consequences.\n * - **Handle Blocking Impacts:** Pay close attention to `blocking` impacts and implement appropriate\n *   logic to handle them.\n * - **Inform the User:** If a deletion cannot proceed, inform the user about the blocking impacts and provide\n *   guidance on how to resolve them.\n * - **Consider Forced Deletion:** In some cases, you may want to allow users to force a deletion even if there are\n *   blocking impacts. In such cases, you should clearly communicate the risks to the user.\n *\n * ## Conclusion\n *\n * The `DomainImpactAnalysis` class is an essential tool for maintaining data integrity when working with complex\n * data domain models. By providing detailed impact reports, it empowers developers to make informed decisions\n * about data deletion and prevent unintended consequences.\n */\nexport class DomainImpactAnalysis {\n  private report: DomainImpactReport\n  private root: DataDomain\n\n  constructor(root: DataDomain) {\n    this.root = root\n    this.report = {\n      key: '',\n      kind: DataDomainKind,\n      impact: [],\n      canProceed: false,\n    }\n  }\n\n  /**\n   * Generates a report of how the data domain will be impacted by the deletion of a data domain object.\n   * @param key The key of the impacted data domain object.\n   * @param kind The kind of the impacted data object.\n   * @returns The delete impact analysis report.\n   */\n  deleteAnalysis(key: string, kind: DomainImpactKinds): DomainImpactReport {\n    this.report = {\n      key,\n      kind,\n      impact: [],\n      canProceed: true,\n    }\n    this.createDeleteImpact(key, kind, key)\n    return this.report\n  }\n\n  /**\n   * Generates a report of how the data domain will be impacted by the removal of a foreign namespace.\n   * @param key The key of the foreign namespace.\n   * @returns The delete impact analysis report.\n   */\n  removeForeignNamespaceAnalysis(key: string): DomainImpactReport {\n    this.report = {\n      key,\n      kind: DomainNamespaceKind,\n      impact: [],\n      canProceed: true,\n    }\n    this.createRemoveForeignNamespaceImpact(key)\n    return this.report\n  }\n\n  /**\n   * Analyzes the data domain for publishing. Essentially, it performs a validation of the data domain\n   * and returns a report of the impact.\n   * @returns The publish impact analysis report.\n   */\n  publishAnalysis(): DomainImpactReport {\n    this.report = {\n      key: '',\n      kind: DataDomainKind,\n      impact: [],\n      canProceed: true,\n    }\n    const entityValidator = new EntityValidation(this.root)\n    const propertyValidator = new PropertyValidation(this.root)\n    const associationValidator = new AssociationValidation(this.root)\n    for (const entity of this.root.listEntities()) {\n      if (entity.domain.key !== this.root.key) {\n        // we don't need to validate foreign entities\n        continue\n      }\n      const report = entityValidator.validate(entity)\n      for (const item of report) {\n        const blocking = item.severity === 'error'\n        this.report.canProceed = this.report.canProceed && !blocking\n        this.report.impact.push({\n          key: item.key,\n          kind: item.kind,\n          type: 'publish',\n          impact: item.message,\n          blocking,\n          resolution: item.help,\n          severity: item.severity,\n          parent: item.parent,\n        })\n      }\n      for (const property of entity.properties) {\n        const report = propertyValidator.validate(property)\n        for (const item of report) {\n          const blocking = item.severity === 'error'\n          this.report.canProceed = this.report.canProceed && !blocking\n          this.report.impact.push({\n            key: item.key,\n            kind: item.kind,\n            type: 'publish',\n            impact: item.message,\n            blocking,\n            resolution: item.help,\n            severity: item.severity,\n            parent: item.parent,\n          })\n        }\n      }\n      for (const association of entity.associations) {\n        const report = associationValidator.validate(association)\n        for (const item of report) {\n          const blocking = item.severity === 'error'\n          this.report.canProceed = this.report.canProceed && !blocking\n          this.report.impact.push({\n            key: item.key,\n            kind: item.kind,\n            type: 'publish',\n            impact: item.message,\n            blocking,\n            resolution: item.help,\n            severity: item.severity,\n            parent: item.parent,\n          })\n        }\n      }\n    }\n    return this.report\n  }\n\n  protected createDeleteImpact(key: string, kind: DomainImpactKinds, rootKey: string): void {\n    switch (kind) {\n      case DomainNamespaceKind:\n        this.deleteNamespaceAnalysis(key, rootKey)\n        break\n      case DomainModelKind:\n        this.deleteModelAnalysis(key, rootKey)\n        break\n      case DomainEntityKind:\n        this.deleteEntityAnalysis(key, rootKey)\n        break\n      case DomainPropertyKind:\n        this.deletePropertyAnalysis(key)\n        break\n      case DomainAssociationKind:\n        this.deleteAssociationAnalysis(key)\n        break\n      default:\n      // ignore unknown kinds\n    }\n  }\n\n  protected deleteNamespaceAnalysis(key: string, rootKey: string): void {\n    const ns = this.root.findNamespace(key)\n    if (!ns) {\n      return\n    }\n    this.report.impact.push({\n      key: ns.key,\n      kind: ns.kind,\n      type: 'delete',\n      impact: `The ${ns.info.getLabel()} ${this.kindToLabel(DomainNamespaceKind)} will be deleted.`,\n      blocking: false,\n      severity: 'info',\n    })\n    for (const child of ns.listNamespaces()) {\n      this.deleteNamespaceAnalysis(child.key, rootKey)\n    }\n    for (const child of ns.listModels()) {\n      this.deleteModelAnalysis(child.key, rootKey)\n    }\n  }\n\n  protected deleteModelAnalysis(key: string, rootKey: string): void {\n    const model = this.root.findModel(key)\n    if (!model) {\n      return\n    }\n    this.report.impact.push({\n      key: model.key,\n      kind: model.kind,\n      type: 'delete',\n      impact: `The ${model.info.getLabel()} ${this.kindToLabel(DomainModelKind)} will be deleted.`,\n      blocking: false,\n      severity: 'info',\n    })\n    for (const child of model.listEntities()) {\n      this.deleteEntityAnalysis(child.key, rootKey)\n    }\n  }\n\n  protected deleteEntityAnalysis(key: string, rootKey: string): void {\n    const entity = this.root.findEntity(key)\n    if (!entity) {\n      return\n    }\n    this.report.impact.push({\n      key: entity.key,\n      kind: entity.kind,\n      type: 'delete',\n      impact: `The ${entity.info.getLabel()} ${this.kindToLabel(DomainEntityKind)} will be deleted.`,\n      blocking: false,\n      severity: 'info',\n    })\n\n    // We need to know whether the entity is a parent of another entity\n    for (const info of this.root.graph.inEdges(key)) {\n      const edge = this.root.graph.edge(info)\n      if (!edge || edge.type !== 'parent') {\n        continue\n      }\n      const childEntity = this.root.findEntity(info.v)\n      if (!childEntity) {\n        continue\n      }\n      if (childEntity.isChildOf(rootKey)) {\n        // No need to include this child as it itself is being deleted\n        continue\n      }\n      const pLabel = entity.info.getLabel()\n      const cLabel = childEntity.info.getLabel()\n      this.report.impact.push({\n        key: childEntity.key,\n        kind: childEntity.kind,\n        type: 'delete',\n        impact: `The \"${cLabel}\" ${this.kindToLabel(DomainEntityKind)} will become an orphan because it is a child of the \"${pLabel}\" entity.`,\n        resolution: `The \"${pLabel}\" entity will be removed as the parent of the \"${cLabel}\" entity.`,\n        blocking: false,\n        relationship: 'child',\n        severity: 'error',\n      })\n      this.report.canProceed = false\n    }\n    // We need to know whether there's another entity that has an association to this entity.\n    for (const edgeInfo of this.root.graph.inEdges(entity.key)) {\n      const edge = this.root.graph.edge(edgeInfo)\n      if (!edge || edge.type !== 'association') {\n        continue\n      }\n      const association = this.root.findAssociation(edgeInfo.v)\n      if (!association) {\n        continue\n      }\n      const targetEntity = association.getParentInstance()\n      if (!targetEntity) {\n        continue\n      }\n      if (targetEntity.isChildOf(rootKey)) {\n        // No need to include this association as the target entity itself is being deleted\n        continue\n      }\n\n      const aLabel = association.info.getLabel()\n      const eLabel = entity.info.getLabel()\n      this.report.impact.push({\n        key: association.key,\n        kind: association.kind,\n        type: 'delete',\n        impact: `The ${aLabel} ${this.kindToLabel(DomainAssociationKind)} will be broken because it has a target to ${eLabel}.`,\n        resolution: `The ${aLabel} ${this.kindToLabel(DomainAssociationKind)} will be removed from ${eLabel}.`,\n        blocking: true,\n        severity: 'error',\n      })\n      this.report.canProceed = false\n    }\n    for (const child of entity.listProperties()) {\n      this.deletePropertyAnalysis(child.key)\n    }\n    for (const child of entity.listAssociations()) {\n      this.deleteAssociationAnalysis(child.key)\n    }\n  }\n\n  protected deletePropertyAnalysis(key: string): void {\n    const property = this.root.findProperty(key)\n    if (!property) {\n      return\n    }\n    this.report.impact.push({\n      key: property.key,\n      kind: property.kind,\n      type: 'delete',\n      impact: `The ${property.info.getLabel()} ${this.kindToLabel(DomainPropertyKind)} will be deleted.`,\n      blocking: false,\n      severity: 'info',\n    })\n  }\n\n  protected deleteAssociationAnalysis(key: string): void {\n    const association = this.root.findAssociation(key)\n    if (!association) {\n      return\n    }\n    this.report.impact.push({\n      key: association.key,\n      kind: association.kind,\n      type: 'delete',\n      impact: `The ${association.info.getLabel()} ${this.kindToLabel(DomainAssociationKind)} will be deleted.`,\n      blocking: false,\n      severity: 'info',\n    })\n  }\n\n  protected kindToLabel(kind: DomainImpactKinds): string {\n    switch (kind) {\n      case DomainNamespaceKind:\n        return 'namespace'\n      case DomainEntityKind:\n        return 'entity'\n      case DomainModelKind:\n        return 'data model'\n      case DomainPropertyKind:\n        return 'property'\n      case DomainAssociationKind:\n        return 'association'\n      default:\n        return 'unknown'\n    }\n  }\n\n  protected createRemoveForeignNamespaceImpact(key: string): void {\n    const foreignNamespace = this.root.dependencies.get(key)\n    if (!foreignNamespace) {\n      return\n    }\n    // Check for parent relationships to foreign entities\n    for (const entity of this.root.listEntities()) {\n      for (const info of this.root.graph.outEdges(entity.key)) {\n        const edge = this.root.graph.edge(info)\n        if (!edge) {\n          continue\n        }\n        if (edge.type === 'parent' && edge.domain === key) {\n          // the parent is in the foreign namespace\n          const parentEntity = this.root.findEntity(info.w)\n          if (!parentEntity) {\n            continue\n          }\n          const eLabel = entity.info.getLabel()\n          const pLabel = parentEntity.info.getLabel()\n          this.report.impact.push({\n            key: entity.key,\n            kind: entity.kind,\n            type: 'delete',\n            impact: `The \"${eLabel}\" ${this.kindToLabel(DomainEntityKind)} will become an orphan because its parent \"${pLabel}\" is in the foreign namespace \"${foreignNamespace.key}\".`,\n            resolution: `The \"${pLabel}\" entity will be removed as the parent of the \"${eLabel}\" entity.`,\n            blocking: true,\n            relationship: 'child',\n            severity: 'error',\n          })\n          this.report.canProceed = false\n        } else if (edge.type === 'association') {\n          const association = this.root.findAssociation(info.w)\n          if (!association) {\n            continue\n          }\n          const targets = association.targets.filter((t) => t.domain === key)\n          if (targets.length) {\n            for (const info of targets) {\n              const targetEntity = this.root.findForeignEntity(info.key, info.domain as string)\n              if (!targetEntity) {\n                continue\n              }\n              const aLabel = association.info.getLabel()\n              const eLabel = entity.info.getLabel()\n              const tLabel = targetEntity.info.getLabel()\n              this.report.impact.push({\n                key: association.key,\n                kind: association.kind,\n                type: 'delete',\n                impact: `The \"${aLabel}\" ${this.kindToLabel(DomainAssociationKind)} from \"${eLabel}\" will be broken because it targets \"${tLabel}\" in the foreign namespace \"${foreignNamespace.key}\".`,\n                resolution: `The \"${aLabel}\" ${this.kindToLabel(DomainAssociationKind)} will be removed from \"${eLabel}\".`,\n                blocking: true,\n                severity: 'error',\n              })\n              this.report.canProceed = false\n            }\n          }\n        }\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"DomainImpactAnalysis.js","sourceRoot":"","sources":["../../../src/modeling/DomainImpactAnalysis.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  DomainNamespaceKind,\n  DomainEntityKind,\n  DomainModelKind,\n  DomainPropertyKind,\n  DomainAssociationKind,\n} from '../models/kinds.js'\nimport type { DataDomain } from './DataDomain.js'\nimport { DomainImpactItem, DomainImpactKinds, DomainImpactReport } from './types.js'\n\n/**\n * # DomainImpactAnalysis\n *\n * The `DomainImpactAnalysis` class is a tool for analyzing the consequences of deleting data domain elements\n * within a `DataDomain`. It helps developers understand the ripple effects of removing a namespace, data model,\n * entity, property, or association, ensuring data integrity and preventing unintended side effects.\n *\n * ## Core Concepts\n *\n * -   **Impact Report:** The central output of the `DomainImpactAnalysis` class is an `DomainImpactReport`.\n *     This report details the potential consequences of a deletion operation, including:\n *     -   The object being deleted (`key`, `kind`).\n *     -   A list of `DomainImpactItem` objects, each describing a specific consequence.\n *     -   Whether the deletion can proceed safely (`canProceed`).\n *\n * -   **DomainImpactItem:** Each `DomainImpactItem` describes a specific consequence of the deletion.\n *     Key properties include:\n *     -   `key`: The key of the impacted object.\n *     -   `kind`: The kind of the impacted object.\n *     -   `type`: The type of impact (currently only `delete`).\n *     -   `impact`: A human-readable description of the impact.\n *     -   `relationship`: The type of relationship between the deleted object and the impacted object (e.g., `child`).\n *     -   `resolution`: A description of how the impact will be resolved if the deletion is forced.\n *     -   `severity`: The severity of the impact, which can be `info`, `warning`, or `error`.\n *\n * -   **Blocking Impacts:** Some impacts are considered \"blocking,\" meaning they prevent the deletion from proceeding\n *     without manual intervention. For example, deleting an entity that is a parent to other entities is\n *     a blocking impact. Blocking impacts are indicated by the `severity` property set to `error`.\n *\n * -   **Non-Blocking Impacts:** Some impacts are informational and do not prevent the deletion. For example, deleting a\n *     property is not a blocking impact.\n *\n * ## Usage\n *\n * 1.  **Instantiation:** Create an instance of `DomainImpactAnalysis`, passing the root `DataDomain` as an argument.\n *\n *     ```typescript\n *     import { DataDomain } from './DataDomain';\n *     import { DomainImpactAnalysis } from './DomainImpactAnalysis';\n *\n *     const dataDomain = new DataDomain();\n *     // ... add some data to the domain\n *     const analyzer = new DomainImpactAnalysis(dataDomain);\n *     ```\n *\n * 2.  **Performing Analysis:** Use the `deleteAnalysis()` method to generate an `DomainImpactReport` for\n *     a specific deletion.\n *     Provide the `key` and `kind` of the object to be deleted.\n *\n *     ```typescript\n *     import { DomainEntityKind } from '../models/kinds.js';\n *     // ...\n *     const entityKey = 'some-entity-key';\n *     const report = analyzer.deleteAnalysis(entityKey, DomainEntityKind);\n *     ```\n *\n * 3.  **Interpreting the Report:** Examine the `DomainImpactReport` to understand the consequences of the deletion.\n *     -   Check `report.canProceed` to see if the deletion is safe.\n *     -   Iterate through `report.impact` to understand each consequence.\n *     -   Pay special attention to `impact.severity` to identify impacts that require manual resolution.\n *\n *     ```typescript\n *     if (report.canProceed) {\n *       // Proceed with deletion\n *     } else {\n *       console.warn('Deletion cannot proceed due to the following impacts:');\n *       report.impact.forEach((item) => {\n *         console.warn(`- ${item.impact}`);\n *         if (item.severity === 'error') {\n *           console.warn(`  - This impact is blocking.`);\n *           if (item.resolution) {\n *             console.warn(`  - Resolution: ${item.resolution}`);\n *           }\n *         }\n *       });\n *       // Handle blocking impacts (e.g., prompt the user, modify the data, etc.)\n *     }\n *     ```\n *\n * ## Supported Deletion Scenarios\n *\n * The `DomainImpactAnalysis` class supports analyzing the deletion of the following data domain element types:\n *\n * - **Namespaces (`DomainNamespaceKind`):** Deleting a namespace also impacts all its child namespaces,\n *   data models, entities, properties, and associations.\n * - **Data Models (`DomainModelKind`):** Deleting a data model impacts all its entities, properties, and associations.\n * - **Entities (`DomainEntityKind`):** Deleting an entity impacts its properties, associations, and any other\n *   entities that have it as a parent or target in an association.\n * - **Properties (`DomainPropertyKind`):** Deleting a property impacts the entity it belongs to.\n * - **Associations (`DomainAssociationKind`):** Deleting an association impacts the entity it belongs to.\n * - **Data Domain (`DataDomainKind`):** Deleting a data domain is not supported.\n *\n * ## Example: Deleting an Entity\n *\n * Consider the following scenario:\n *\n * ```\n * DataDomain\n *   - Namespace: `MyNamespace`\n *     -   Data Model: `ProductModel`\n *         -   Entity: `Product`\n *             -   Property: `name`\n *             -   Association: `category` (targets `Category` entity)\n *         -   Entity: `Category`\n *             - Property: `name`\n *         - Entity: `SpecialProduct` (parent: `Product`)\n * ```\n *\n * If you attempt to delete the `Product` entity, the `DomainImpactAnalysis` will generate a report similar to this:\n *\n * ```json\n * {\n *   \"key\": \"Product\",\n *   \"kind\": \"DomainEntityKind\",\n *   \"impact\": [\n *     {\n *       \"key\": \"Product\",\n *       \"kind\": \"DomainEntityKind\",\n *       \"type\": \"delete\",\n *       \"impact\": \"The entity with key Product will be deleted.\",\n *       \"severity\": \"warning\"\n *     },\n *     {\n *       \"key\": \"SpecialProduct\",\n *       \"kind\": \"DomainEntityKind\",\n *       \"type\": \"delete\",\n *       \"impact\": \"The SpecialProduct entity will become an orphan because it is a child of Product.\",\n *       \"resolution\": \"The \\\"Product\\\" entity will be removed as the parent of the \\\"SpecialProduct\\\" entity.\",\n *       \"severity\": \"error\",\n *       \"relationship\": \"child\"\n *     },\n *     {\n *       \"key\": \"category\",\n *       \"kind\": \"DomainAssociationKind\",\n *       \"type\": \"delete\",\n *       \"impact\": \"The association with key category will be broken because it has a target to Product.\",\n *       \"resolution\": \"The association with key category will be removed from Product.\",\n *       \"severity\": \"error\"\n *     },\n *     {\n *       \"key\": \"name\",\n *       \"kind\": \"DomainPropertyKind\",\n *       \"type\": \"delete\",\n *       \"impact\": \"The property with key name will be deleted.\",\n *       \"severity\": \"info\"\n *     }\n *   ],\n *   \"canProceed\": false\n * }\n * ```\n *\n * This report indicates that:\n *\n * -   The `Product` entity will be deleted.\n * -   The `SpecialProduct` entity will become an orphan (blocking).\n * -   The `category` association will be broken (blocking).\n * -   The `name` property will be deleted.\n * -   The deletion cannot proceed without addressing the blocking impacts.\n *\n * ## Types\n *\n * ### `DomainImpactKinds`\n *\n * -   **Description:** A type alias for the kinds of data domain elements that can be analyzed.\n * -   **Values:**\n *     - `DomainNamespaceKind`\n *     - `DomainEntityKind`\n *     - `DomainModelKind`\n *     - `DomainPropertyKind`\n *     - `DomainAssociationKind`\n *     - `DataDomainKind`\n *\n * ## Error Handling\n *\n * The `DomainImpactAnalysis` class does not throw errors. Instead, it uses the `DomainImpactReport` to communicate\n * the results of the analysis, including any blocking impacts.\n *\n * ## Best Practices\n *\n * - **Always Analyze Before Deleting:** Before deleting any data domain element, always use `DomainImpactAnalysis`\n *   to understand the consequences.\n * - **Handle Blocking Impacts:** Pay close attention to `severity = \"error\"` impacts and implement appropriate\n *   logic to handle them.\n * - **Inform the User:** If a deletion cannot proceed, inform the user about the blocking impacts and provide\n *   guidance on how to resolve them.\n * - **Consider Forced Deletion:** In some cases, you may want to allow users to force a deletion even if there are\n *   blocking impacts. In such cases, you should clearly communicate the risks to the user.\n *\n * ## Conclusion\n *\n * The `DomainImpactAnalysis` class is an essential tool for maintaining data integrity when working with complex\n * data domain models. By providing detailed impact reports, it empowers developers to make informed decisions\n * about data deletion and prevent unintended consequences.\n */\nexport class DomainImpactAnalysis {\n  private root: DataDomain\n\n  constructor(root: DataDomain) {\n    this.root = root\n  }\n\n  /**\n   * Generates a report of how the data domain will be impacted by the deletion of a data domain object.\n   * @param key The key of the impacted data domain object.\n   * @param kind The kind of the impacted data object.\n   * @returns The delete impact analysis report.\n   */\n  deleteAnalysis(key: string, kind: DomainImpactKinds): DomainImpactReport {\n    const report: DomainImpactReport = {\n      key,\n      kind,\n      impact: [],\n      canProceed: true,\n    }\n    this.createDeleteImpact(key, kind, key, report.impact)\n    report.canProceed = this.computeCanProceed(report.impact)\n    return report\n  }\n\n  /**\n   * Generates a report of how the data domain will be impacted by the removal of a foreign namespace.\n   * @param key The key of the foreign namespace.\n   * @returns The delete impact analysis report.\n   */\n  removeForeignNamespaceAnalysis(key: string): DomainImpactReport {\n    const report: DomainImpactReport = {\n      key,\n      kind: DomainNamespaceKind,\n      impact: [],\n      canProceed: true,\n    }\n    this.createRemoveForeignNamespaceImpact(key, report.impact)\n    report.canProceed = this.computeCanProceed(report.impact)\n    return report\n  }\n\n  /**\n   * Computes whether the deletion can proceed based on the impact report.\n   * @param impact The list of impacts from the analysis.\n   * @returns `true` if the deletion can proceed, `false` otherwise.\n   */\n  protected computeCanProceed(impact: DomainImpactItem[]): boolean {\n    return !impact.some((item) => item.severity === 'error')\n  }\n\n  protected createDeleteImpact(\n    key: string,\n    kind: DomainImpactKinds,\n    rootKey: string,\n    impact: DomainImpactItem[]\n  ): void {\n    switch (kind) {\n      case DomainNamespaceKind:\n        this.deleteNamespaceAnalysis(key, rootKey, impact)\n        break\n      case DomainModelKind:\n        this.deleteModelAnalysis(key, rootKey, impact)\n        break\n      case DomainEntityKind:\n        this.deleteEntityAnalysis(key, rootKey, impact)\n        break\n      case DomainPropertyKind:\n        this.deletePropertyAnalysis(key, impact)\n        break\n      case DomainAssociationKind:\n        this.deleteAssociationAnalysis(key, impact)\n        break\n      default:\n      // ignore unknown kinds\n    }\n  }\n\n  protected deleteNamespaceAnalysis(key: string, rootKey: string, impact: DomainImpactItem[]): void {\n    const ns = this.root.findNamespace(key)\n    if (!ns) {\n      return\n    }\n    impact.push({\n      key: ns.key,\n      kind: ns.kind,\n      type: 'delete',\n      impact: `The ${ns.info.getLabel()} ${this.kindToLabel(DomainNamespaceKind)} will be deleted.`,\n      severity: 'info',\n    })\n    for (const child of ns.listNamespaces()) {\n      this.deleteNamespaceAnalysis(child.key, rootKey, impact)\n    }\n    for (const child of ns.listModels()) {\n      this.deleteModelAnalysis(child.key, rootKey, impact)\n    }\n  }\n\n  protected deleteModelAnalysis(key: string, rootKey: string, impact: DomainImpactItem[]): void {\n    const model = this.root.findModel(key)\n    if (!model) {\n      return\n    }\n    impact.push({\n      key: model.key,\n      kind: model.kind,\n      type: 'delete',\n      impact: `The ${model.info.getLabel()} ${this.kindToLabel(DomainModelKind)} will be deleted.`,\n      severity: 'info',\n    })\n    for (const child of model.listEntities()) {\n      this.deleteEntityAnalysis(child.key, rootKey, impact)\n    }\n  }\n\n  protected deleteEntityAnalysis(key: string, rootKey: string, impact: DomainImpactItem[]): void {\n    const entity = this.root.findEntity(key)\n    if (!entity) {\n      return\n    }\n    impact.push({\n      key: entity.key,\n      kind: entity.kind,\n      type: 'delete',\n      impact: `The ${entity.info.getLabel()} ${this.kindToLabel(DomainEntityKind)} will be deleted.`,\n      severity: 'info',\n    })\n\n    // We need to know whether the entity is a parent of another entity\n    for (const info of this.root.graph.inEdges(key)) {\n      const edge = this.root.graph.edge(info)\n      if (!edge || edge.type !== 'parent') {\n        continue\n      }\n      const childEntity = this.root.findEntity(info.v)\n      if (!childEntity) {\n        continue\n      }\n      if (childEntity.isChildOf(rootKey)) {\n        // No need to include this child as it itself is being deleted\n        continue\n      }\n      const pLabel = entity.info.getLabel()\n      const cLabel = childEntity.info.getLabel()\n      impact.push({\n        key: childEntity.key,\n        kind: childEntity.kind,\n        type: 'delete',\n        impact: `The \"${cLabel}\" ${this.kindToLabel(DomainEntityKind)} will become an orphan because it is a child of the \"${pLabel}\" entity.`,\n        resolution: `The \"${pLabel}\" entity will be removed as the parent of the \"${cLabel}\" entity.`,\n        relationship: 'child',\n        severity: 'error',\n      })\n    }\n    // We need to know whether there's another entity that has an association to this entity.\n    for (const edgeInfo of this.root.graph.inEdges(entity.key)) {\n      const edge = this.root.graph.edge(edgeInfo)\n      if (!edge || edge.type !== 'association') {\n        continue\n      }\n      const association = this.root.findAssociation(edgeInfo.v)\n      if (!association) {\n        continue\n      }\n      const targetEntity = association.getParentInstance()\n      if (!targetEntity) {\n        continue\n      }\n      if (targetEntity.isChildOf(rootKey)) {\n        // No need to include this association as the target entity itself is being deleted\n        continue\n      }\n\n      const aLabel = association.info.getLabel()\n      const eLabel = entity.info.getLabel()\n      impact.push({\n        key: association.key,\n        kind: association.kind,\n        type: 'delete',\n        impact: `The ${aLabel} ${this.kindToLabel(DomainAssociationKind)} will be broken because it has a target to ${eLabel}.`,\n        resolution: `The ${aLabel} ${this.kindToLabel(DomainAssociationKind)} will be removed from ${eLabel}.`,\n        severity: 'error',\n      })\n    }\n    for (const child of entity.listProperties()) {\n      this.deletePropertyAnalysis(child.key, impact)\n    }\n    for (const child of entity.listAssociations()) {\n      this.deleteAssociationAnalysis(child.key, impact)\n    }\n  }\n\n  protected deletePropertyAnalysis(key: string, impact: DomainImpactItem[]): void {\n    const property = this.root.findProperty(key)\n    if (!property) {\n      return\n    }\n    impact.push({\n      key: property.key,\n      kind: property.kind,\n      type: 'delete',\n      impact: `The ${property.info.getLabel()} ${this.kindToLabel(DomainPropertyKind)} will be deleted.`,\n      severity: 'info',\n    })\n  }\n\n  protected deleteAssociationAnalysis(key: string, impact: DomainImpactItem[]): void {\n    const association = this.root.findAssociation(key)\n    if (!association) {\n      return\n    }\n    impact.push({\n      key: association.key,\n      kind: association.kind,\n      type: 'delete',\n      impact: `The ${association.info.getLabel()} ${this.kindToLabel(DomainAssociationKind)} will be deleted.`,\n      severity: 'info',\n    })\n  }\n\n  protected kindToLabel(kind: DomainImpactKinds): string {\n    switch (kind) {\n      case DomainNamespaceKind:\n        return 'namespace'\n      case DomainEntityKind:\n        return 'entity'\n      case DomainModelKind:\n        return 'data model'\n      case DomainPropertyKind:\n        return 'property'\n      case DomainAssociationKind:\n        return 'association'\n      default:\n        return 'unknown'\n    }\n  }\n\n  protected createRemoveForeignNamespaceImpact(key: string, impact: DomainImpactItem[]): void {\n    const foreignNamespace = this.root.dependencies.get(key)\n    if (!foreignNamespace) {\n      return\n    }\n    // Check for parent relationships to foreign entities\n    for (const entity of this.root.listEntities()) {\n      for (const info of this.root.graph.outEdges(entity.key)) {\n        const edge = this.root.graph.edge(info)\n        if (!edge) {\n          continue\n        }\n        if (edge.type === 'parent' && edge.domain === key) {\n          // the parent is in the foreign namespace\n          const parentEntity = this.root.findEntity(info.w)\n          if (!parentEntity) {\n            continue\n          }\n          const eLabel = entity.info.getLabel()\n          const pLabel = parentEntity.info.getLabel()\n          impact.push({\n            key: entity.key,\n            kind: entity.kind,\n            type: 'delete',\n            impact: `The \"${eLabel}\" ${this.kindToLabel(DomainEntityKind)} will become an orphan because its parent \"${pLabel}\" is in the foreign namespace \"${foreignNamespace.key}\".`,\n            resolution: `The \"${pLabel}\" entity will be removed as the parent of the \"${eLabel}\" entity.`,\n            relationship: 'child',\n            severity: 'error',\n          })\n        } else if (edge.type === 'association') {\n          const association = this.root.findAssociation(info.w)\n          if (!association) {\n            continue\n          }\n          const targets = association.targets.filter((t) => t.domain === key)\n          if (targets.length) {\n            for (const info of targets) {\n              const targetEntity = this.root.findForeignEntity(info.key, info.domain as string)\n              if (!targetEntity) {\n                continue\n              }\n              const aLabel = association.info.getLabel()\n              const eLabel = entity.info.getLabel()\n              const tLabel = targetEntity.info.getLabel()\n              impact.push({\n                key: association.key,\n                kind: association.kind,\n                type: 'delete',\n                impact: `The \"${aLabel}\" ${this.kindToLabel(DomainAssociationKind)} from \"${eLabel}\" will be broken because it targets \"${tLabel}\" in the foreign namespace \"${foreignNamespace.key}\".`,\n                resolution: `The \"${aLabel}\" ${this.kindToLabel(DomainAssociationKind)} will be removed from \"${eLabel}\".`,\n                severity: 'error',\n              })\n            }\n          }\n        }\n      }\n    }\n  }\n}\n"]}

package/build/src/modeling/DomainValidation.d.ts

@@ -0,0 +1,8 @@
+import { DataDomain } from './DataDomain.js';
+import { DomainImpactReport } from './types.js';
+export declare class DomainValidation {
+    private root;
+    constructor(root: DataDomain);
+    validate(): DomainImpactReport;
+}
+//# sourceMappingURL=DomainValidation.d.ts.map

package/build/src/modeling/DomainValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DomainValidation.d.ts","sourceRoot":"","sources":["../../../src/modeling/DomainValidation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAM/C,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAY;gBAEZ,IAAI,EAAE,UAAU;IAI5B,QAAQ,IAAI,kBAAkB;CAyF/B"}