@api-client/core 0.18.13 → 0.18.15

package/build/src/modeling/importers/SchemaFilteringStrategy.d.ts

@@ -0,0 +1,72 @@
+import type { JSONSchema7 } from 'json-schema';
+/**
+ * Configuration options for schema filtering during import.
+ */
+export interface SchemaFilteringOptions {
+    /**
+     * Whether to exclude schemas that are empty objects with no properties.
+     * Default: false
+     */
+    excludeEmptyObjects?: boolean;
+    /**
+     * Whether to exclude schemas that only serve as conceptual markers.
+     * These are typically schemas with only type: "object" and description
+     * but no properties, constraints, or meaningful structure.
+     * Default: false
+     */
+    excludeConceptualMarkers?: boolean;
+    /**
+     * Custom predicate function to determine if a schema should be excluded.
+     * Return true to exclude the schema from import.
+     */
+    customExclusionFilter?: (schema: JSONSchema7, schemaId?: string) => boolean;
+    /**
+     * List of schema IDs to explicitly exclude.
+     */
+    excludeSchemaIds?: string[];
+    /**
+     * Patterns to match against schema titles or IDs for exclusion.
+     */
+    excludePatterns?: RegExp[];
+}
+/**
+ * Strategy class for determining which schemas should be filtered out during import.
+ */
+export declare class SchemaFilteringStrategy {
+    private options;
+    constructor(options?: SchemaFilteringOptions);
+    /**
+     * Determines whether a schema should be excluded from import.
+     */
+    shouldExcludeSchema(schema: JSONSchema7, schemaId?: string): boolean;
+    /**
+     * Checks if a schema represents an empty object with no meaningful structure.
+     */
+    private isEmptyObjectSchema;
+    /**
+     * Checks if a schema is likely a conceptual marker with no structural value.
+     */
+    private isConceptualMarkerSchema;
+    /**
+     * Gets a human-readable reason why a schema was excluded.
+     */
+    getExclusionReason(schema: JSONSchema7, schemaId?: string): string;
+}
+/**
+ * Predefined filtering strategies for common use cases.
+ */
+export declare const FILTERING_STRATEGIES: {
+    /**
+     * Strategy for API modeling - excludes schemas that don't contribute to API structure.
+     */
+    readonly API_MODELING: SchemaFilteringStrategy;
+    /**
+     * Strategy for database modeling - very strict, only includes schemas with concrete properties.
+     */
+    readonly DATABASE_MODELING: SchemaFilteringStrategy;
+    /**
+     * Conservative strategy - only excludes obviously empty schemas.
+     */
+    readonly CONSERVATIVE: SchemaFilteringStrategy;
+};
+//# sourceMappingURL=SchemaFilteringStrategy.d.ts.map

package/build/src/modeling/importers/SchemaFilteringStrategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaFilteringStrategy.d.ts","sourceRoot":"","sources":["../../../../src/modeling/importers/SchemaFilteringStrategy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAE7B;;;;;OAKG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAA;IAElC;;;OAGG;IACH,qBAAqB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;IAE3E;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE3B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAA;CAC3B;AAED;;GAEG;AACH,qBAAa,uBAAuB;IACtB,OAAO,CAAC,OAAO;gBAAP,OAAO,GAAE,sBAA2B;IAExD;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO;IAiCpE;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkB3B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAoChC;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;CAenE;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;OAEG;;IAUH;;OAEG;;IAiBH;;OAEG;;CAIK,CAAA"}

package/build/src/modeling/importers/SchemaFilteringStrategy.js

@@ -0,0 +1,140 @@
+/**
+ * Strategy class for determining which schemas should be filtered out during import.
+ */
+export class SchemaFilteringStrategy {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    /**
+     * Determines whether a schema should be excluded from import.
+     */
+    shouldExcludeSchema(schema, schemaId) {
+        // Check explicit exclusion list
+        if (schemaId && this.options.excludeSchemaIds?.includes(schemaId)) {
+            return true;
+        }
+        // Check pattern exclusions
+        if (schemaId && this.options.excludePatterns) {
+            for (const pattern of this.options.excludePatterns) {
+                if (pattern.test(schemaId) || (schema.title && pattern.test(schema.title))) {
+                    return true;
+                }
+            }
+        }
+        // Check for empty objects
+        if (this.options.excludeEmptyObjects && this.isEmptyObjectSchema(schema)) {
+            return true;
+        }
+        // Check for conceptual markers
+        if (this.options.excludeConceptualMarkers && this.isConceptualMarkerSchema(schema)) {
+            return true;
+        }
+        // Apply custom filter
+        if (this.options.customExclusionFilter?.(schema, schemaId)) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Checks if a schema represents an empty object with no meaningful structure.
+     */
+    isEmptyObjectSchema(schema) {
+        return (schema.type === 'object' &&
+            (!schema.properties || Object.keys(schema.properties).length === 0) &&
+            !schema.additionalProperties &&
+            !schema.patternProperties &&
+            !schema.allOf &&
+            !schema.oneOf &&
+            !schema.anyOf &&
+            !schema.if &&
+            !schema.then &&
+            !schema.else &&
+            !schema.required?.length &&
+            !schema.minProperties &&
+            !schema.maxProperties);
+    }
+    /**
+     * Checks if a schema is likely a conceptual marker with no structural value.
+     */
+    isConceptualMarkerSchema(schema) {
+        // Check for schemas that are just empty objects or only have allOf with references
+        if (this.isEmptyObjectSchema(schema)) {
+            return true;
+        }
+        // Check for schemas that only contain a single allOf with a $ref (like ActionStatusType)
+        if (schema.type === 'object' &&
+            schema.allOf?.length === 1 &&
+            typeof schema.allOf[0] === 'object' &&
+            '$ref' in schema.allOf[0] &&
+            !schema.properties &&
+            !schema.additionalProperties) {
+            return true;
+        }
+        // Check for schemas that only have description and type but no structure
+        if (schema.type === 'object' &&
+            schema.description &&
+            !schema.properties &&
+            !schema.additionalProperties &&
+            !schema.allOf &&
+            !schema.oneOf &&
+            !schema.anyOf &&
+            Object.keys(schema).filter((key) => !['$schema', '$id', 'title', 'description', 'type'].includes(key)).length ===
+                0) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Gets a human-readable reason why a schema was excluded.
+     */
+    getExclusionReason(schema, schemaId) {
+        if (schemaId && this.options.excludeSchemaIds?.includes(schemaId)) {
+            return `Schema ID '${schemaId}' is in the exclusion list`;
+        }
+        if (this.isEmptyObjectSchema(schema)) {
+            return 'Schema is an empty object with no structural definition';
+        }
+        if (this.isConceptualMarkerSchema(schema)) {
+            return 'Schema appears to be a conceptual marker with no concrete structure';
+        }
+        return 'Schema excluded by custom filter';
+    }
+}
+/**
+ * Predefined filtering strategies for common use cases.
+ */
+export const FILTERING_STRATEGIES = {
+    /**
+     * Strategy for API modeling - excludes schemas that don't contribute to API structure.
+     */
+    API_MODELING: new SchemaFilteringStrategy({
+        excludeEmptyObjects: true,
+        excludeConceptualMarkers: true,
+        excludePatterns: [
+            /.*Enumeration$/, // Exclude *Enumeration schemas
+            /.*Type$/, // Exclude conceptual *Type schemas that are just markers
+        ],
+    }),
+    /**
+     * Strategy for database modeling - very strict, only includes schemas with concrete properties.
+     */
+    DATABASE_MODELING: new SchemaFilteringStrategy({
+        excludeEmptyObjects: true,
+        excludeConceptualMarkers: true,
+        customExclusionFilter: (schema) => {
+            // For database modeling, exclude anything that doesn't have properties or clear structure
+            return (schema.type === 'object' &&
+                !schema.properties &&
+                !schema.additionalProperties &&
+                !schema.allOf?.some((subSchema) => typeof subSchema === 'object' && 'properties' in subSchema && subSchema.properties));
+        },
+    }),
+    /**
+     * Conservative strategy - only excludes obviously empty schemas.
+     */
+    CONSERVATIVE: new SchemaFilteringStrategy({
+        excludeEmptyObjects: true,
+    }),
+};
+//# sourceMappingURL=SchemaFilteringStrategy.js.map

package/build/src/modeling/importers/SchemaFilteringStrategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SchemaFilteringStrategy.js","sourceRoot":"","sources":["../../../../src/modeling/importers/SchemaFilteringStrategy.ts"],"names":[],"mappings":"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","sourcesContent":["import type { JSONSchema7 } from 'json-schema'\n\n/**\n * Configuration options for schema filtering during import.\n */\nexport interface SchemaFilteringOptions {\n  /**\n   * Whether to exclude schemas that are empty objects with no properties.\n   * Default: false\n   */\n  excludeEmptyObjects?: boolean\n\n  /**\n   * Whether to exclude schemas that only serve as conceptual markers.\n   * These are typically schemas with only type: \"object\" and description\n   * but no properties, constraints, or meaningful structure.\n   * Default: false\n   */\n  excludeConceptualMarkers?: boolean\n\n  /**\n   * Custom predicate function to determine if a schema should be excluded.\n   * Return true to exclude the schema from import.\n   */\n  customExclusionFilter?: (schema: JSONSchema7, schemaId?: string) => boolean\n\n  /**\n   * List of schema IDs to explicitly exclude.\n   */\n  excludeSchemaIds?: string[]\n\n  /**\n   * Patterns to match against schema titles or IDs for exclusion.\n   */\n  excludePatterns?: RegExp[]\n}\n\n/**\n * Strategy class for determining which schemas should be filtered out during import.\n */\nexport class SchemaFilteringStrategy {\n  constructor(private options: SchemaFilteringOptions = {}) {}\n\n  /**\n   * Determines whether a schema should be excluded from import.\n   */\n  shouldExcludeSchema(schema: JSONSchema7, schemaId?: string): boolean {\n    // Check explicit exclusion list\n    if (schemaId && this.options.excludeSchemaIds?.includes(schemaId)) {\n      return true\n    }\n\n    // Check pattern exclusions\n    if (schemaId && this.options.excludePatterns) {\n      for (const pattern of this.options.excludePatterns) {\n        if (pattern.test(schemaId) || (schema.title && pattern.test(schema.title))) {\n          return true\n        }\n      }\n    }\n\n    // Check for empty objects\n    if (this.options.excludeEmptyObjects && this.isEmptyObjectSchema(schema)) {\n      return true\n    }\n\n    // Check for conceptual markers\n    if (this.options.excludeConceptualMarkers && this.isConceptualMarkerSchema(schema)) {\n      return true\n    }\n\n    // Apply custom filter\n    if (this.options.customExclusionFilter?.(schema, schemaId)) {\n      return true\n    }\n\n    return false\n  }\n\n  /**\n   * Checks if a schema represents an empty object with no meaningful structure.\n   */\n  private isEmptyObjectSchema(schema: JSONSchema7): boolean {\n    return (\n      schema.type === 'object' &&\n      (!schema.properties || Object.keys(schema.properties).length === 0) &&\n      !schema.additionalProperties &&\n      !schema.patternProperties &&\n      !schema.allOf &&\n      !schema.oneOf &&\n      !schema.anyOf &&\n      !schema.if &&\n      !schema.then &&\n      !schema.else &&\n      !schema.required?.length &&\n      !schema.minProperties &&\n      !schema.maxProperties\n    )\n  }\n\n  /**\n   * Checks if a schema is likely a conceptual marker with no structural value.\n   */\n  private isConceptualMarkerSchema(schema: JSONSchema7): boolean {\n    // Check for schemas that are just empty objects or only have allOf with references\n    if (this.isEmptyObjectSchema(schema)) {\n      return true\n    }\n\n    // Check for schemas that only contain a single allOf with a $ref (like ActionStatusType)\n    if (\n      schema.type === 'object' &&\n      schema.allOf?.length === 1 &&\n      typeof schema.allOf[0] === 'object' &&\n      '$ref' in schema.allOf[0] &&\n      !schema.properties &&\n      !schema.additionalProperties\n    ) {\n      return true\n    }\n\n    // Check for schemas that only have description and type but no structure\n    if (\n      schema.type === 'object' &&\n      schema.description &&\n      !schema.properties &&\n      !schema.additionalProperties &&\n      !schema.allOf &&\n      !schema.oneOf &&\n      !schema.anyOf &&\n      Object.keys(schema).filter((key) => !['$schema', '$id', 'title', 'description', 'type'].includes(key)).length ===\n        0\n    ) {\n      return true\n    }\n\n    return false\n  }\n\n  /**\n   * Gets a human-readable reason why a schema was excluded.\n   */\n  getExclusionReason(schema: JSONSchema7, schemaId?: string): string {\n    if (schemaId && this.options.excludeSchemaIds?.includes(schemaId)) {\n      return `Schema ID '${schemaId}' is in the exclusion list`\n    }\n\n    if (this.isEmptyObjectSchema(schema)) {\n      return 'Schema is an empty object with no structural definition'\n    }\n\n    if (this.isConceptualMarkerSchema(schema)) {\n      return 'Schema appears to be a conceptual marker with no concrete structure'\n    }\n\n    return 'Schema excluded by custom filter'\n  }\n}\n\n/**\n * Predefined filtering strategies for common use cases.\n */\nexport const FILTERING_STRATEGIES = {\n  /**\n   * Strategy for API modeling - excludes schemas that don't contribute to API structure.\n   */\n  API_MODELING: new SchemaFilteringStrategy({\n    excludeEmptyObjects: true,\n    excludeConceptualMarkers: true,\n    excludePatterns: [\n      /.*Enumeration$/, // Exclude *Enumeration schemas\n      /.*Type$/, // Exclude conceptual *Type schemas that are just markers\n    ],\n  }),\n\n  /**\n   * Strategy for database modeling - very strict, only includes schemas with concrete properties.\n   */\n  DATABASE_MODELING: new SchemaFilteringStrategy({\n    excludeEmptyObjects: true,\n    excludeConceptualMarkers: true,\n    customExclusionFilter: (schema: JSONSchema7) => {\n      // For database modeling, exclude anything that doesn't have properties or clear structure\n      return (\n        schema.type === 'object' &&\n        !schema.properties &&\n        !schema.additionalProperties &&\n        !schema.allOf?.some(\n          (subSchema) => typeof subSchema === 'object' && 'properties' in subSchema && subSchema.properties\n        )\n      )\n    },\n  }),\n\n  /**\n   * Conservative strategy - only excludes obviously empty schemas.\n   */\n  CONSERVATIVE: new SchemaFilteringStrategy({\n    excludeEmptyObjects: true,\n  }),\n} as const\n"]}

package/build/src/modeling/validation/entity_validation.d.ts

@@ -14,15 +14,29 @@ export declare class EntityValidation {
     /**
      * Performs all the validation rules on the entity.
      * If you are interested in a specific rule, use the specific method.
-     * @param target The target entity to validate. Can be a string with the entity key or a DomainEntity object.
+     * @param target The target entity to validate. Can be a string with
+     *               the entity key or a DomainEntity object.
      */
     validate(target: string | DomainEntity): DomainValidation[];
     /**
-     * Validates the entity against the primary key validation rules.
+     * Validates the entity primary key.
      * @param entity The entity to validate
-     * @returns The list of validation messages.
      */
     validatePrimaryKey(entity: DomainEntity): DomainValidation[];
+    /**
+     * Checks if an entity has properties through its entire inheritance chain.
+     * This includes direct properties and properties inherited from any level of parent entities.
+     * @param entity The entity to check
+     * @returns True if the entity has properties either directly or through inheritance
+     */
+    private hasPropertiesInherited;
+    /**
+     * Checks if an entity has associations through its entire inheritance chain.
+     * This includes direct associations and associations inherited from any level of parent entities.
+     * @param entity The entity to check
+     * @returns True if the entity has associations either directly or through inheritance
+     */
+    private hasAssociationsInherited;
     /**
      * Checks if the entity has the minimum required properties.
      * @param entity The entity to validate

package/build/src/modeling/validation/entity_validation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity_validation.d.ts","sourceRoot":"","sources":["../../../../src/modeling/validation/entity_validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACf,SAAS,CAAC,MAAM,EAAE,UAAU;gBAAlB,MAAM,EAAE,UAAU;IAExC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,gBAAgB,EAAE;IAiC3D;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAmB5D;;;OAGG;IACH,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAkBnE;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAuFtD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;CAwCrD"}
+{"version":3,"file":"entity_validation.d.ts","sourceRoot":"","sources":["../../../../src/modeling/validation/entity_validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;GAMG;AACH,qBAAa,gBAAgB;IACf,SAAS,CAAC,MAAM,EAAE,UAAU;gBAAlB,MAAM,EAAE,UAAU;IAExC;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,gBAAgB,EAAE;IAiC3D;;;OAGG;IACH,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAmB5D;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAgB9B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAgBhC;;;OAGG;IACH,yBAAyB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAuBnE;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;IAuFtD;;;OAGG;IACH,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,EAAE;CAwCrD"}

package/build/src/modeling/validation/entity_validation.js

@@ -15,7 +15,8 @@ export class EntityValidation {
     /**
      * Performs all the validation rules on the entity.
      * If you are interested in a specific rule, use the specific method.
-     * @param target The target entity to validate. Can be a string with the entity key or a DomainEntity object.
+     * @param target The target entity to validate. Can be a string with
+     *               the entity key or a DomainEntity object.
      */
     validate(target) {
         const results = [];
@@ -40,20 +41,19 @@ export class EntityValidation {
             });
             return results;
         }
-        const primary = this.validatePrimaryKey(entity);
-        results.push(...primary);
-        const minimum = this.minimumRequiredProperties(entity);
-        results.push(...minimum);
+        const primaryKey = this.validatePrimaryKey(entity);
+        results.push(...primaryKey);
+        const minimumProperties = this.minimumRequiredProperties(entity);
+        results.push(...minimumProperties);
         const name = this.validateName(entity);
         results.push(...name);
-        const uniqueName = this.uniqueName(entity);
-        results.push(...uniqueName);
+        const unique = this.uniqueName(entity);
+        results.push(...unique);
         return results;
     }
     /**
-     * Validates the entity against the primary key validation rules.
+     * Validates the entity primary key.
      * @param entity The entity to validate
-     * @returns The list of validation messages.
      */
     validatePrimaryKey(entity) {
         const results = [];
@@ -73,13 +73,54 @@ export class EntityValidation {
         }
         return results;
     }
+    /**
+     * Checks if an entity has properties through its entire inheritance chain.
+     * This includes direct properties and properties inherited from any level of parent entities.
+     * @param entity The entity to check
+     * @returns True if the entity has properties either directly or through inheritance
+     */
+    hasPropertiesInherited(entity) {
+        // Check direct properties first
+        if (entity.hasProperties()) {
+            return true;
+        }
+        // Check all parents recursively
+        for (const parent of entity.listParents()) {
+            if (this.hasPropertiesInherited(parent)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Checks if an entity has associations through its entire inheritance chain.
+     * This includes direct associations and associations inherited from any level of parent entities.
+     * @param entity The entity to check
+     * @returns True if the entity has associations either directly or through inheritance
+     */
+    hasAssociationsInherited(entity) {
+        // Check direct associations first
+        if (entity.hasAssociations()) {
+            return true;
+        }
+        // Check all parents recursively
+        for (const parent of entity.listParents()) {
+            if (this.hasAssociationsInherited(parent)) {
+                return true;
+            }
+        }
+        return false;
+    }
     /**
      * Checks if the entity has the minimum required properties.
      * @param entity The entity to validate
      */
     minimumRequiredProperties(entity) {
         const results = [];
-        if (!entity.hasProperties() && !entity.hasAssociations()) {
+        // Check if entity has properties or associations through entire inheritance chain
+        const hasProperties = this.hasPropertiesInherited(entity);
+        const hasAssociations = this.hasAssociationsInherited(entity);
+        if (!hasProperties && !hasAssociations) {
             const message = `The "${entity.info.getLabel()}" entity has no properties. It will be ignored.`;
             const help = `Entities that have no properties are ignored in the data domain. No schema will be generated for it.`;
             results.push({

package/build/src/modeling/validation/entity_validation.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity_validation.js","sourceRoot":"","sources":["../../../../src/modeling/validation/entity_validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { DomainEntityKind } from '../../models/kinds.js'\nimport type { DataDomain } from '../DataDomain.js'\nimport type { DomainEntity } from '../DomainEntity.js'\nimport { ReservedKeywords } from './postgresql.js'\nimport type { DomainValidation } from './rules.js'\n\n/**\n * EntityValidation is a class that performs validation on entities in a data domain.\n *\n * @remarks\n * - We do not need to check for parent uniqueness here, because in the graph there can only be one edge\n *   between two nodes. Parent relationships are described by an edge in the graph.\n */\nexport class EntityValidation {\n  constructor(protected domain: DataDomain) {}\n\n  /**\n   * Performs all the validation rules on the entity.\n   * If you are interested in a specific rule, use the specific method.\n   * @param target The target entity to validate. Can be a string with the entity key or a DomainEntity object.\n   */\n  validate(target: string | DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    let entity: DomainEntity | undefined\n    if (typeof target === 'string') {\n      entity = this.domain.findEntity(target)\n    } else {\n      entity = target\n    }\n    if (!entity) {\n      const message = `The \"${target}\" entity does not exist.`\n      const help = `The entity must be defined in the domain.`\n      results.push({\n        field: '*',\n        rule: 'exists',\n        message,\n        help,\n        key: target as string,\n        kind: DomainEntityKind,\n        severity: 'error',\n      })\n      return results\n    }\n    const primary = this.validatePrimaryKey(entity)\n    results.push(...primary)\n    const minimum = this.minimumRequiredProperties(entity)\n    results.push(...minimum)\n    const name = this.validateName(entity)\n    results.push(...name)\n    const uniqueName = this.uniqueName(entity)\n    results.push(...uniqueName)\n    return results\n  }\n\n  /**\n   * Validates the entity against the primary key validation rules.\n   * @param entity The entity to validate\n   * @returns The list of validation messages.\n   */\n  validatePrimaryKey(entity: DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    const primary = entity.primaryKey()\n    if (!primary) {\n      const message = `The \"${entity.info.getLabel()}\" entity has no identifier.`\n      const help = `An entity that can exists by itself must have identifier defined.`\n      results.push({\n        field: 'properties',\n        rule: 'primary_key',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    return results\n  }\n\n  /**\n   * Checks if the entity has the minimum required properties.\n   * @param entity The entity to validate\n   */\n  minimumRequiredProperties(entity: DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    if (!entity.hasProperties() && !entity.hasAssociations()) {\n      const message = `The \"${entity.info.getLabel()}\" entity has no properties. It will be ignored.`\n      const help = `Entities that have no properties are ignored in the data domain. No schema will be generated for it.`\n      results.push({\n        field: 'properties',\n        rule: 'required',\n        message,\n        help,\n        severity: 'warning',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    return results\n  }\n\n  /**\n   * Validates the entity name.\n   *\n   * @remarks\n   * - An entity must have a name defined.\n   * - The name has to follow the same rules as the names in a PostgreSQL database.\n   *   - Table names must start with a letter (a-z) or underscore (_).\n   *   - Subsequent characters can be letters, digits (0-9), or underscores (_).\n   *   - Names are case-insensitive.\n   *   - The maximum length of a table name is 31 characters\n   *   - Should be snake case (it's a convention, not an error).\n   *   - Should not be a reserved word (for example: \"IN\", \"SELECT\", \"FROM\", etc.).\n   * @param entity The entity to validate\n   */\n  validateName(entity: DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    const label = entity.info.getLabel()\n    if (!entity.info.name) {\n      const message = `The \"${label}\" entity has no name.`\n      const help = `An entity must have a name.`\n      results.push({\n        field: 'name',\n        rule: 'required',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n      return results\n    }\n\n    const name = entity.info.name\n    if (name.length < 2) {\n      const message = `The \"${label}\" entity name is too short.`\n      const help = `The name must be at least 2 characters long.`\n      results.push({\n        field: 'name',\n        rule: 'length',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    if (name.length > 31) {\n      const message = `The \"${label}\" entity name is too long.`\n      const help = `The name must be at most 31 characters long.`\n      results.push({\n        field: 'name',\n        rule: 'length',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {\n      const message = `The \"${label}\" entity name is invalid.`\n      const help = `The name must start with a letter (a-z) or underscore (_). Subsequent characters can be letters, digits (0-9), or underscores (_).`\n      results.push({\n        field: 'name',\n        rule: 'format',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    if (/^[A-Z]/.test(name)) {\n      const message = `The \"${label}\" entity name is not in snake case.`\n      const help = `The name should be in snake case (lowercase letters and underscores).`\n      results.push({\n        field: 'name',\n        rule: 'snake_case',\n        message,\n        help,\n        severity: 'info',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    if (ReservedKeywords.has(name.toUpperCase())) {\n      const message = `The \"${label}\" entity name is a reserved keyword.`\n      const help = `The name should not be a reserved keyword.`\n      results.push({\n        field: 'name',\n        rule: 'reserved',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    return results\n  }\n\n  /**\n   * Checks if the entity name is unique in the data domain.\n   * @param entity The entity to validate\n   */\n  uniqueName(entity: DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    const name = entity.info.name?.toLowerCase()\n    if (!name) {\n      return results\n    }\n    // We need to check the unique names in all entities, including foreign ones.\n    for (const other of this.domain.listEntities()) {\n      if (other.info.name?.toLowerCase() === name && other.key !== entity.key) {\n        const message = `The \"${name}\" entity name is already used in the data domain.`\n        const help = `The name must be unique. This includes references to other data domains.`\n        results.push({\n          field: 'name',\n          rule: 'unique',\n          message,\n          help,\n          severity: 'error',\n          key: other.key,\n          kind: other.kind,\n        })\n      }\n    }\n    for (const other of this.domain.listAllForeignEntities()) {\n      if (other.info.name?.toLowerCase() === name && other.key !== entity.key) {\n        const message = `The \"${name}\" entity name is already used in the foreign data domain.`\n        const help = `The name must be unique. This includes references to other data domains.`\n        results.push({\n          field: 'name',\n          rule: 'unique',\n          message,\n          help,\n          severity: 'error',\n          key: other.key,\n          kind: other.kind,\n          parent: other.domain.key,\n        })\n      }\n    }\n    return results\n  }\n}\n"]}
+{"version":3,"file":"entity_validation.js","sourceRoot":"","sources":["../../../../src/modeling/validation/entity_validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { DomainEntityKind } from '../../models/kinds.js'\nimport type { DataDomain } from '../DataDomain.js'\nimport type { DomainEntity } from '../DomainEntity.js'\nimport { ReservedKeywords } from './postgresql.js'\nimport type { DomainValidation } from './rules.js'\n\n/**\n * EntityValidation is a class that performs validation on entities in a data domain.\n *\n * @remarks\n * - We do not need to check for parent uniqueness here, because in the graph there can only be one edge\n *   between two nodes. Parent relationships are described by an edge in the graph.\n */\nexport class EntityValidation {\n  constructor(protected domain: DataDomain) {}\n\n  /**\n   * Performs all the validation rules on the entity.\n   * If you are interested in a specific rule, use the specific method.\n   * @param target The target entity to validate. Can be a string with\n   *               the entity key or a DomainEntity object.\n   */\n  validate(target: string | DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    let entity: DomainEntity | undefined\n    if (typeof target === 'string') {\n      entity = this.domain.findEntity(target)\n    } else {\n      entity = target\n    }\n    if (!entity) {\n      const message = `The \"${target}\" entity does not exist.`\n      const help = `The entity must be defined in the domain.`\n      results.push({\n        field: '*',\n        rule: 'exists',\n        message,\n        help,\n        key: target as string,\n        kind: DomainEntityKind,\n        severity: 'error',\n      })\n      return results\n    }\n    const primaryKey = this.validatePrimaryKey(entity)\n    results.push(...primaryKey)\n    const minimumProperties = this.minimumRequiredProperties(entity)\n    results.push(...minimumProperties)\n    const name = this.validateName(entity)\n    results.push(...name)\n    const unique = this.uniqueName(entity)\n    results.push(...unique)\n    return results\n  }\n\n  /**\n   * Validates the entity primary key.\n   * @param entity The entity to validate\n   */\n  validatePrimaryKey(entity: DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    const primary = entity.primaryKey()\n    if (!primary) {\n      const message = `The \"${entity.info.getLabel()}\" entity has no identifier.`\n      const help = `An entity that can exists by itself must have identifier defined.`\n      results.push({\n        field: 'properties',\n        rule: 'primary_key',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    return results\n  }\n\n  /**\n   * Checks if an entity has properties through its entire inheritance chain.\n   * This includes direct properties and properties inherited from any level of parent entities.\n   * @param entity The entity to check\n   * @returns True if the entity has properties either directly or through inheritance\n   */\n  private hasPropertiesInherited(entity: DomainEntity): boolean {\n    // Check direct properties first\n    if (entity.hasProperties()) {\n      return true\n    }\n\n    // Check all parents recursively\n    for (const parent of entity.listParents()) {\n      if (this.hasPropertiesInherited(parent)) {\n        return true\n      }\n    }\n\n    return false\n  }\n\n  /**\n   * Checks if an entity has associations through its entire inheritance chain.\n   * This includes direct associations and associations inherited from any level of parent entities.\n   * @param entity The entity to check\n   * @returns True if the entity has associations either directly or through inheritance\n   */\n  private hasAssociationsInherited(entity: DomainEntity): boolean {\n    // Check direct associations first\n    if (entity.hasAssociations()) {\n      return true\n    }\n\n    // Check all parents recursively\n    for (const parent of entity.listParents()) {\n      if (this.hasAssociationsInherited(parent)) {\n        return true\n      }\n    }\n\n    return false\n  }\n\n  /**\n   * Checks if the entity has the minimum required properties.\n   * @param entity The entity to validate\n   */\n  minimumRequiredProperties(entity: DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n\n    // Check if entity has properties or associations through entire inheritance chain\n    const hasProperties = this.hasPropertiesInherited(entity)\n    const hasAssociations = this.hasAssociationsInherited(entity)\n\n    if (!hasProperties && !hasAssociations) {\n      const message = `The \"${entity.info.getLabel()}\" entity has no properties. It will be ignored.`\n      const help = `Entities that have no properties are ignored in the data domain. No schema will be generated for it.`\n      results.push({\n        field: 'properties',\n        rule: 'required',\n        message,\n        help,\n        severity: 'warning',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    return results\n  }\n\n  /**\n   * Validates the entity name.\n   *\n   * @remarks\n   * - An entity must have a name defined.\n   * - The name has to follow the same rules as the names in a PostgreSQL database.\n   *   - Table names must start with a letter (a-z) or underscore (_).\n   *   - Subsequent characters can be letters, digits (0-9), or underscores (_).\n   *   - Names are case-insensitive.\n   *   - The maximum length of a table name is 31 characters\n   *   - Should be snake case (it's a convention, not an error).\n   *   - Should not be a reserved word (for example: \"IN\", \"SELECT\", \"FROM\", etc.).\n   * @param entity The entity to validate\n   */\n  validateName(entity: DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    const label = entity.info.getLabel()\n    if (!entity.info.name) {\n      const message = `The \"${label}\" entity has no name.`\n      const help = `An entity must have a name.`\n      results.push({\n        field: 'name',\n        rule: 'required',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n      return results\n    }\n\n    const name = entity.info.name\n    if (name.length < 2) {\n      const message = `The \"${label}\" entity name is too short.`\n      const help = `The name must be at least 2 characters long.`\n      results.push({\n        field: 'name',\n        rule: 'length',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    if (name.length > 31) {\n      const message = `The \"${label}\" entity name is too long.`\n      const help = `The name must be at most 31 characters long.`\n      results.push({\n        field: 'name',\n        rule: 'length',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name)) {\n      const message = `The \"${label}\" entity name is invalid.`\n      const help = `The name must start with a letter (a-z) or underscore (_). Subsequent characters can be letters, digits (0-9), or underscores (_).`\n      results.push({\n        field: 'name',\n        rule: 'format',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    if (/^[A-Z]/.test(name)) {\n      const message = `The \"${label}\" entity name is not in snake case.`\n      const help = `The name should be in snake case (lowercase letters and underscores).`\n      results.push({\n        field: 'name',\n        rule: 'snake_case',\n        message,\n        help,\n        severity: 'info',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    if (ReservedKeywords.has(name.toUpperCase())) {\n      const message = `The \"${label}\" entity name is a reserved keyword.`\n      const help = `The name should not be a reserved keyword.`\n      results.push({\n        field: 'name',\n        rule: 'reserved',\n        message,\n        help,\n        severity: 'error',\n        key: entity.key,\n        kind: entity.kind,\n      })\n    }\n    return results\n  }\n\n  /**\n   * Checks if the entity name is unique in the data domain.\n   * @param entity The entity to validate\n   */\n  uniqueName(entity: DomainEntity): DomainValidation[] {\n    const results: DomainValidation[] = []\n    const name = entity.info.name?.toLowerCase()\n    if (!name) {\n      return results\n    }\n    // We need to check the unique names in all entities, including foreign ones.\n    for (const other of this.domain.listEntities()) {\n      if (other.info.name?.toLowerCase() === name && other.key !== entity.key) {\n        const message = `The \"${name}\" entity name is already used in the data domain.`\n        const help = `The name must be unique. This includes references to other data domains.`\n        results.push({\n          field: 'name',\n          rule: 'unique',\n          message,\n          help,\n          severity: 'error',\n          key: other.key,\n          kind: other.kind,\n        })\n      }\n    }\n    for (const other of this.domain.listAllForeignEntities()) {\n      if (other.info.name?.toLowerCase() === name && other.key !== entity.key) {\n        const message = `The \"${name}\" entity name is already used in the foreign data domain.`\n        const help = `The name must be unique. This includes references to other data domains.`\n        results.push({\n          field: 'name',\n          rule: 'unique',\n          message,\n          help,\n          severity: 'error',\n          key: other.key,\n          kind: other.kind,\n          parent: other.domain.key,\n        })\n      }\n    }\n    return results\n  }\n}\n"]}