@api-client/core 0.19.11 → 0.19.13

package/build/src/modeling/DomainValidation.js

@@ -1,4 +1,3 @@
-import { 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';
@@ -73,9 +72,32 @@ import { SemanticValidation } from './validation/semantic_validation.js';
  * @see {@link SemanticValidation} for detailed semantic validation rules
  */
 export class DomainValidation {
-    root;
-    constructor(root) {
-        this.root = root;
+    domain;
+    report = [];
+    #infoCount = 0;
+    #warningCount = 0;
+    #errorCount = 0;
+    #counted = false;
+    get infoCount() {
+        if (!this.#counted) {
+            this.computeIssueCounters();
+        }
+        return this.#infoCount;
+    }
+    get warningCount() {
+        if (!this.#counted) {
+            this.computeIssueCounters();
+        }
+        return this.#warningCount;
+    }
+    get errorCount() {
+        if (!this.#counted) {
+            this.computeIssueCounters();
+        }
+        return this.#errorCount;
+    }
+    constructor(domain) {
+        this.domain = domain;
     }
     /**
      * Performs comprehensive validation on the entire data domain.
@@ -87,91 +109,52 @@ export class DomainValidation {
      * @returns A comprehensive validation report with all issues found
      */
     validate() {
-        const result = {
-            key: '',
-            kind: DataDomainKind,
-            impact: [],
-            canProceed: true,
-        };
-        const entityValidator = new EntityValidation(this.root);
-        const propertyValidator = new PropertyValidation(this.root);
-        const associationValidator = new AssociationValidation(this.root);
-        const semanticValidator = new SemanticValidation(this.root);
+        this.#counted = false;
+        this.report = [];
+        const entityValidator = new EntityValidation(this.domain);
+        const propertyValidator = new PropertyValidation(this.domain);
+        const associationValidator = new AssociationValidation(this.domain);
+        const semanticValidator = new SemanticValidation(this.domain);
         let hasEntities = false;
-        // Validate entities, properties, and associations
-        for (const entity of this.root.listEntities()) {
-            if (entity.domain.key !== this.root.key) {
+        for (const entity of this.domain.listEntities()) {
+            if (entity.domain.key !== this.domain.key) {
                 // we don't need to validate foreign entities
                 continue;
             }
             hasEntities = true;
-            const report = entityValidator.validate(entity);
-            for (const item of report) {
-                const blocking = item.severity === 'error';
-                result.canProceed = result.canProceed && !blocking;
-                result.impact.push({
-                    key: item.key,
-                    kind: item.kind,
-                    type: 'publish',
-                    impact: item.message,
-                    resolution: item.help,
-                    severity: item.severity,
-                    parent: item.parent,
-                });
-            }
+            const entities = entityValidator.validate(entity);
+            this.report.push(...entities);
             for (const property of entity.properties) {
-                const report = propertyValidator.validate(property);
-                for (const item of report) {
-                    const blocking = item.severity === 'error';
-                    result.canProceed = result.canProceed && !blocking;
-                    result.impact.push({
-                        key: item.key,
-                        kind: item.kind,
-                        type: 'publish',
-                        impact: item.message,
-                        resolution: item.help,
-                        severity: item.severity,
-                        parent: item.parent,
-                    });
+                if (property.domain.key !== this.domain.key) {
+                    // we don't need to validate foreign properties
+                    continue;
                 }
+                const properties = propertyValidator.validate(property);
+                this.report.push(...properties);
             }
             for (const association of entity.associations) {
-                const report = associationValidator.validate(association);
-                for (const item of report) {
-                    const blocking = item.severity === 'error';
-                    result.canProceed = result.canProceed && !blocking;
-                    result.impact.push({
-                        key: item.key,
-                        kind: item.kind,
-                        type: 'publish',
-                        impact: item.message,
-                        resolution: item.help,
-                        severity: item.severity,
-                        parent: item.parent,
-                    });
+                if (association.domain.key !== this.domain.key) {
+                    // we don't need to validate foreign properties
+                    continue;
                 }
+                const associations = associationValidator.validate(association);
+                this.report.push(...associations);
             }
         }
         if (!hasEntities) {
             // no entities, no need to validate anything else
-            return result;
+            return this.report;
         }
         // Validate semantics
         const semanticReport = semanticValidator.validate();
-        for (const item of semanticReport) {
-            const blocking = item.severity === 'error';
-            result.canProceed = result.canProceed && !blocking;
-            result.impact.push({
-                key: item.key,
-                kind: item.kind,
-                type: 'publish',
-                impact: item.message,
-                resolution: item.help,
-                severity: item.severity,
-                parent: item.parent,
-            });
-        }
-        return result;
+        this.report.push(...semanticReport);
+        return this.report;
+    }
+    computeIssueCounters() {
+        this.#infoCount = this.report.filter((validation) => validation.severity === 'info').length;
+        this.#warningCount = this.report.filter((validation) => validation.severity === 'warning').length;
+        this.#errorCount = this.report.filter((validation) => validation.severity === 'error').length;
+        this.#counted = true;
     }
 }
 //# sourceMappingURL=DomainValidation.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"DomainValidation.js","sourceRoot":"","sources":["../../../src/modeling/DomainValidation.ts"],"names":[],"mappings":"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","sourcesContent":["import { DataDomainKind } from '../models/kinds.js'\nimport { DataDomain } from './DataDomain.js'\nimport type { DomainImpactReport } from './types.js'\nimport { AssociationValidation } from './validation/association_validation.js'\nimport { EntityValidation } from './validation/entity_validation.js'\nimport { PropertyValidation } from './validation/property_validation.js'\nimport { SemanticValidation } from './validation/semantic_validation.js'\n\n/**\n * DomainValidation performs comprehensive validation on a data domain and its components.\n *\n * This class orchestrates validation across all domain elements including entities, properties,\n * associations, and semantics. It ensures that the data domain is well-formed and follows\n * established conventions before it can be published or used in API generation.\n *\n * ## Validation Scope\n *\n * The validation process covers:\n * - **Entities**: Structure, naming, primary keys, and inheritance\n * - **Properties**: Naming conventions, data types, and constraints\n * - **Associations**: Relationships, targets, and naming\n * - **Semantics**: Recommended patterns and best practices\n *\n * ## Validation Severity Levels\n *\n * - **Error**: Blocking issues that prevent domain publication\n * - **Warning**: Issues that may cause problems but don't block publication\n * - **Info**: Recommendations for best practices\n *\n * ## Usage\n *\n * ```typescript\n * const domain = new DataDomain()\n * // ... add entities, properties, associations\n *\n * const validator = new DomainValidation(domain)\n * const report = validator.validate()\n *\n * if (report.canProceed) {\n *   // Domain is valid and can be published\n * } else {\n *   // Handle validation errors\n *   console.log(report.impact)\n * }\n * ```\n *\n * ## Validation Rules\n *\n * ### Entity Validation Rules\n * - **Primary Key**: Each entity must have a primary key (can be inherited)\n * - **Minimum Properties**: Entities should have properties or associations (can be inherited)\n * - **Naming**: Entity names must follow PostgreSQL naming conventions\n * - **Uniqueness**: Entity names must be unique within the domain\n *\n * ### Property Validation Rules\n * - **Naming**: Properties must follow PostgreSQL column naming conventions\n * - **Length**: Names must be 2-59 characters long\n * - **Format**: Names must start with letter/underscore, contain only alphanumeric/underscore\n * - **Reserved Words**: Names cannot be PostgreSQL reserved keywords\n * - **Case**: Snake case is recommended (lowercase with underscores)\n *\n * ### Association Validation Rules\n * - **Targets**: Associations must have at least one target entity\n * - **Target Existence**: Target entities must exist in the domain\n * - **Naming**: Same rules as properties\n *\n * ### Semantic Validation Rules\n * - **User Entity**: Recommended to have at least one entity with User semantic\n * - **Timestamps**: Recommended to have CreatedTimestamp and UpdatedTimestamp properties\n * - **Soft Delete**: Recommended to have soft delete capability for entities\n * - **Data Types**: Semantic-specific data type validation\n *\n * @see {@link EntityValidation} for detailed entity validation rules\n * @see {@link PropertyValidation} for detailed property validation rules\n * @see {@link AssociationValidation} for detailed association validation rules\n * @see {@link SemanticValidation} for detailed semantic validation rules\n */\nexport class DomainValidation {\n  private root: DataDomain\n\n  constructor(root: DataDomain) {\n    this.root = root\n  }\n\n  /**\n   * Performs comprehensive validation on the entire data domain.\n   *\n   * This method validates all entities, properties, associations, and semantics\n   * in the domain. It returns a detailed report of all validation issues found,\n   * categorized by severity level.\n   *\n   * @returns A comprehensive validation report with all issues found\n   */\n  validate(): DomainImpactReport {\n    const result: DomainImpactReport = {\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    const semanticValidator = new SemanticValidation(this.root)\n\n    let hasEntities = false\n    // Validate entities, properties, and associations\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      hasEntities = true\n      const report = entityValidator.validate(entity)\n      for (const item of report) {\n        const blocking = item.severity === 'error'\n        result.canProceed = result.canProceed && !blocking\n        result.impact.push({\n          key: item.key,\n          kind: item.kind,\n          type: 'publish',\n          impact: item.message,\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          result.canProceed = result.canProceed && !blocking\n          result.impact.push({\n            key: item.key,\n            kind: item.kind,\n            type: 'publish',\n            impact: item.message,\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          result.canProceed = result.canProceed && !blocking\n          result.impact.push({\n            key: item.key,\n            kind: item.kind,\n            type: 'publish',\n            impact: item.message,\n            resolution: item.help,\n            severity: item.severity,\n            parent: item.parent,\n          })\n        }\n      }\n    }\n    if (!hasEntities) {\n      // no entities, no need to validate anything else\n      return result\n    }\n    // Validate semantics\n    const semanticReport = semanticValidator.validate()\n    for (const item of semanticReport) {\n      const blocking = item.severity === 'error'\n      result.canProceed = result.canProceed && !blocking\n      result.impact.push({\n        key: item.key,\n        kind: item.kind,\n        type: 'publish',\n        impact: item.message,\n        resolution: item.help,\n        severity: item.severity,\n        parent: item.parent,\n      })\n    }\n\n    return result\n  }\n}\n"]}
+{"version":3,"file":"DomainValidation.js","sourceRoot":"","sources":["../../../src/modeling/DomainValidation.ts"],"names":[],"mappings":"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","sourcesContent":["import { 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'\nimport { DomainValidationSchema } from './validation/rules.js'\nimport { SemanticValidation } from './validation/semantic_validation.js'\n\n/**\n * DomainValidation performs comprehensive validation on a data domain and its components.\n *\n * This class orchestrates validation across all domain elements including entities, properties,\n * associations, and semantics. It ensures that the data domain is well-formed and follows\n * established conventions before it can be published or used in API generation.\n *\n * ## Validation Scope\n *\n * The validation process covers:\n * - **Entities**: Structure, naming, primary keys, and inheritance\n * - **Properties**: Naming conventions, data types, and constraints\n * - **Associations**: Relationships, targets, and naming\n * - **Semantics**: Recommended patterns and best practices\n *\n * ## Validation Severity Levels\n *\n * - **Error**: Blocking issues that prevent domain publication\n * - **Warning**: Issues that may cause problems but don't block publication\n * - **Info**: Recommendations for best practices\n *\n * ## Usage\n *\n * ```typescript\n * const domain = new DataDomain()\n * // ... add entities, properties, associations\n *\n * const validator = new DomainValidation(domain)\n * const report = validator.validate()\n *\n * if (report.canProceed) {\n *   // Domain is valid and can be published\n * } else {\n *   // Handle validation errors\n *   console.log(report.impact)\n * }\n * ```\n *\n * ## Validation Rules\n *\n * ### Entity Validation Rules\n * - **Primary Key**: Each entity must have a primary key (can be inherited)\n * - **Minimum Properties**: Entities should have properties or associations (can be inherited)\n * - **Naming**: Entity names must follow PostgreSQL naming conventions\n * - **Uniqueness**: Entity names must be unique within the domain\n *\n * ### Property Validation Rules\n * - **Naming**: Properties must follow PostgreSQL column naming conventions\n * - **Length**: Names must be 2-59 characters long\n * - **Format**: Names must start with letter/underscore, contain only alphanumeric/underscore\n * - **Reserved Words**: Names cannot be PostgreSQL reserved keywords\n * - **Case**: Snake case is recommended (lowercase with underscores)\n *\n * ### Association Validation Rules\n * - **Targets**: Associations must have at least one target entity\n * - **Target Existence**: Target entities must exist in the domain\n * - **Naming**: Same rules as properties\n *\n * ### Semantic Validation Rules\n * - **User Entity**: Recommended to have at least one entity with User semantic\n * - **Timestamps**: Recommended to have CreatedTimestamp and UpdatedTimestamp properties\n * - **Soft Delete**: Recommended to have soft delete capability for entities\n * - **Data Types**: Semantic-specific data type validation\n *\n * @see {@link EntityValidation} for detailed entity validation rules\n * @see {@link PropertyValidation} for detailed property validation rules\n * @see {@link AssociationValidation} for detailed association validation rules\n * @see {@link SemanticValidation} for detailed semantic validation rules\n */\nexport class DomainValidation {\n  report: DomainValidationSchema[] = []\n  #infoCount = 0\n  #warningCount = 0\n  #errorCount = 0\n  #counted = false\n\n  get infoCount(): number {\n    if (!this.#counted) {\n      this.computeIssueCounters()\n    }\n    return this.#infoCount\n  }\n\n  get warningCount(): number {\n    if (!this.#counted) {\n      this.computeIssueCounters()\n    }\n    return this.#warningCount\n  }\n\n  get errorCount(): number {\n    if (!this.#counted) {\n      this.computeIssueCounters()\n    }\n    return this.#errorCount\n  }\n\n  constructor(protected domain: DataDomain) {}\n\n  /**\n   * Performs comprehensive validation on the entire data domain.\n   *\n   * This method validates all entities, properties, associations, and semantics\n   * in the domain. It returns a detailed report of all validation issues found,\n   * categorized by severity level.\n   *\n   * @returns A comprehensive validation report with all issues found\n   */\n  validate(): DomainValidationSchema[] {\n    this.#counted = false\n    this.report = []\n    const entityValidator = new EntityValidation(this.domain)\n    const propertyValidator = new PropertyValidation(this.domain)\n    const associationValidator = new AssociationValidation(this.domain)\n    const semanticValidator = new SemanticValidation(this.domain)\n\n    let hasEntities = false\n    for (const entity of this.domain.listEntities()) {\n      if (entity.domain.key !== this.domain.key) {\n        // we don't need to validate foreign entities\n        continue\n      }\n      hasEntities = true\n      const entities = entityValidator.validate(entity)\n      this.report.push(...entities)\n      for (const property of entity.properties) {\n        if (property.domain.key !== this.domain.key) {\n          // we don't need to validate foreign properties\n          continue\n        }\n        const properties = propertyValidator.validate(property)\n        this.report.push(...properties)\n      }\n      for (const association of entity.associations) {\n        if (association.domain.key !== this.domain.key) {\n          // we don't need to validate foreign properties\n          continue\n        }\n        const associations = associationValidator.validate(association)\n        this.report.push(...associations)\n      }\n    }\n    if (!hasEntities) {\n      // no entities, no need to validate anything else\n      return this.report\n    }\n    // Validate semantics\n    const semanticReport = semanticValidator.validate()\n    this.report.push(...semanticReport)\n    return this.report\n  }\n\n  computeIssueCounters(): void {\n    this.#infoCount = this.report.filter((validation) => validation.severity === 'info').length\n    this.#warningCount = this.report.filter((validation) => validation.severity === 'warning').length\n    this.#errorCount = this.report.filter((validation) => validation.severity === 'error').length\n    this.#counted = true\n  }\n}\n"]}

package/build/src/modeling/ExposedEntity.js

@@ -326,9 +326,9 @@ let ExposedEntity = (() => {
                 }
                 return;
             }
-            // No collection: allow any two segments
-            if (segments.length !== 2) {
-                throw new Error(`Resource path must contain exactly two segments when no collection is present. Received: "${cleaned}"`);
+            // No collection: allow exactly one segment
+            if (segments.length !== 1) {
+                throw new Error(`Resource path must contain exactly one segment when no collection is present. Received: "${cleaned}"`);
             }
             // Check for collision if this is a root entity (singleton case)
             if (this.isRoot) {
@@ -338,7 +338,7 @@ let ExposedEntity = (() => {
                 }
             }
             if (this.resourcePath !== cleaned) {
-                this.resourcePath = `/${segments[0]}/${segments[1]}`;
+                this.resourcePath = `/${segments[0]}`;
             }
         }
         /**

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

@@ -1 +1 @@
-{"version":3,"file":"ExposedEntity.js","sourceRoot":"","sources":["../../../src/modeling/ExposedEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import { observed } from '../decorators/observed.js'\nimport { ExposedEntityKind } from '../models/kinds.js'\nimport { nanoid } from '../nanoid.js'\nimport { Action } from './actions/Action.js'\nimport { restoreAction } from './actions/index.js'\nimport type { ApiModel } from './ApiModel.js'\nimport { ensureLeadingSlash, joinPaths } from './helpers/endpointHelpers.js'\nimport { AccessRule } from './rules/AccessRule.js'\nimport { type RateLimitRule, restoreAccessRule } from './rules/index.js'\nimport { RateLimitingConfiguration } from './rules/RateLimitingConfiguration.js'\nimport type { AssociationTarget, ExposeOptions, ExposeParentRef, ExposedEntitySchema } from './types.js'\n\n/**\n * A class that specializes in representing an exposed Data Entity within an API Model.\n *\n * ## Design Note\n * This class enforces strict path constraints (e.g., single-segment collection paths like `/users`,\n * two-segment resource paths like `/users/{id}`).\n * This is an intentional design choice to support a UI paradigm for non-technical users, ensuring that\n * path segments are configured individually at each level of the exposure hierarchy.\n *\n * Flexibility is achieved by chaining exposed entities (parent/child relationships), where the final\n * absolute path is composed of all ancestral paths. See `getAbsoluteResourcePath()` and `getAbsoluteCollectionPath()`.\n *\n * @fires change - Emitted when the exposed entity has changed.\n */\nexport class ExposedEntity extends EventTarget {\n  /**\n   * The exposed entity kind recognizable by the ecosystem.\n   */\n  kind: typeof ExposedEntityKind\n\n  /**\n   * The unique key of the exposed entity.\n   * This is a stable identifier that does not change across versions.\n   */\n  key: string\n\n  /**\n   * A pointer to a Data Entity from the Data Domain.\n   */\n  @observed() accessor entity: AssociationTarget\n\n  /**\n   * Indicates whether this exposure has a collection endpoint.\n   * A collection endpoint is optional for nested exposures where the association is 1:1\n   * and the schema is embedded directly under the parent resource.\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  hasCollection: boolean\n\n  /**\n   * Path to the collection endpoint for this exposure.\n   * Starts with '/'. Not set for 1:1 nested exposures where collection does not exist.\n   */\n  @observed() accessor collectionPath: string | undefined\n\n  /**\n   * Path to the resource endpoint for this exposure.\n   * Starts with '/'. For 1:1 nested exposures the resource path typically does not include an id segment.\n   */\n  @observed() accessor resourcePath: string\n\n  /**\n   * Whether this exposure is a root exposure (top-level collection).\n   * If this is set then the `parent` reference must be populated.\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  isRoot?: boolean\n\n  /**\n   * Parent reference when this exposure was created via following an association.\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  parent?: ExposeParentRef\n\n  /**\n   * Expose-time config used to create this exposure (persisted for auditing/UI).\n   * This is only populated for the root exposure. All children exposures inherit this config.\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  exposeOptions?: ExposeOptions\n\n  /**\n   * The list of enabled API actions for this exposure (List/Read/Create/etc.)\n   */\n  @observed({ deep: true }) accessor actions: Action[]\n\n  /**\n   * Optional array of access rules that define the access control policies for this exposure.\n   */\n  @observed({ deep: true }) accessor accessRule: AccessRule[] | undefined\n\n  /**\n   * Optional configuration for rate limiting for this exposure.\n   */\n  @observed() accessor rateLimiting: RateLimitingConfiguration | undefined\n\n  /**\n   * When true, generation for this exposure hit configured limits\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  truncated?: boolean\n\n  /**\n   * When the notifying flag is set to true,\n   * the domain is pending a notification.\n   * No other notifications will be sent until\n   * the current notification is sent.\n   */\n  #notifying = false\n  /**\n   * When the initializing flag is set to true,\n   * the domain is not notified of changes.\n   */\n  #initializing = true\n  /**\n   * A reference to the parent API Model instance.\n   */\n  api: ApiModel\n\n  static createSchema(input: Partial<ExposedEntitySchema> = {}): ExposedEntitySchema {\n    const {\n      key = nanoid(),\n      entity = { key: '' },\n      collectionPath,\n      resourcePath = '/',\n      hasCollection = true,\n      isRoot,\n      parent,\n      exposeOptions,\n      actions = [],\n      accessRule,\n      rateLimiting,\n      truncated,\n    } = input\n    const result: ExposedEntitySchema = {\n      kind: ExposedEntityKind,\n      key,\n      entity: { ...entity },\n      hasCollection,\n      resourcePath,\n      actions: actions.map((a) => ({ ...a })),\n    }\n    if (collectionPath !== undefined) {\n      result.collectionPath = collectionPath\n    }\n    if (isRoot !== undefined) {\n      result.isRoot = isRoot\n    }\n    if (parent !== undefined) {\n      result.parent = { ...parent }\n    }\n    if (exposeOptions !== undefined) {\n      result.exposeOptions = { ...exposeOptions }\n    }\n    if (Array.isArray(accessRule)) {\n      result.accessRule = accessRule.map((ar) => ({ ...ar }))\n    }\n    if (rateLimiting !== undefined) {\n      result.rateLimiting = { ...rateLimiting }\n    }\n    if (truncated !== undefined) {\n      result.truncated = truncated\n    }\n    return result\n  }\n\n  constructor(model: ApiModel, state?: Partial<ExposedEntitySchema>) {\n    super()\n    this.api = model\n    const init = ExposedEntity.createSchema(state)\n    this.kind = init.kind\n    this.key = init.key\n    this.entity = init.entity\n    this.hasCollection = init.hasCollection\n    this.collectionPath = init.collectionPath\n    this.resourcePath = init.resourcePath\n    this.isRoot = init.isRoot\n    this.parent = init.parent\n    this.exposeOptions = init.exposeOptions\n    this.actions = init.actions ? init.actions.map((a) => restoreAction(this, a)) : []\n    this.accessRule = init.accessRule ? init.accessRule.map((ar) => restoreAccessRule(ar)) : []\n    this.rateLimiting = init.rateLimiting ? new RateLimitingConfiguration(init.rateLimiting) : undefined\n    this.truncated = init.truncated\n    this.#initializing = false\n  }\n\n  notifyChange() {\n    if (this.#notifying || this.#initializing) {\n      return\n    }\n    this.#notifying = true\n    queueMicrotask(() => {\n      this.#notifying = false\n      const event = new Event('change')\n      this.dispatchEvent(event)\n    })\n  }\n\n  toJSON(): ExposedEntitySchema {\n    const result: ExposedEntitySchema = {\n      kind: this.kind,\n      key: this.key,\n      entity: { ...this.entity },\n      resourcePath: this.resourcePath,\n      actions: this.actions.map((a) => a.toJSON()),\n      hasCollection: this.hasCollection,\n    }\n    if (this.collectionPath !== undefined) {\n      result.collectionPath = this.collectionPath\n    }\n    if (this.isRoot !== undefined) {\n      result.isRoot = this.isRoot\n    }\n    if (this.parent !== undefined) {\n      result.parent = { ...this.parent }\n    }\n    if (this.exposeOptions !== undefined) {\n      result.exposeOptions = { ...this.exposeOptions }\n    }\n    if (Array.isArray(this.accessRule) && this.accessRule.length > 0) {\n      result.accessRule = this.accessRule.map((ar) => ar.toJSON())\n    }\n    if (this.rateLimiting !== undefined) {\n      result.rateLimiting = this.rateLimiting.toJSON()\n    }\n    if (this.truncated !== undefined) {\n      result.truncated = this.truncated\n    }\n    return result\n  }\n\n  /**\n   * Sets a new collection path for this exposed entity.\n   *\n   * It:\n   * - updates the collectionPath property\n   * - updates the absoluteCollectionPath property accordingly\n   * - updates the resourcePath accordingly.\n   * @param path The new path to set.\n   */\n  setCollectionPath(path: string) {\n    if (!this.hasCollection) {\n      throw new Error(`Cannot set collection path on an exposure that does not have a collection`)\n    }\n    const cleaned = ensureLeadingSlash(path)\n    // Ensure exactly one non-empty segment\n    const segments = cleaned.split('/').filter(Boolean)\n    if (segments.length !== 1) {\n      throw new Error(`Collection path must contain exactly one segment. Received: \"${path}\"`)\n    }\n    const normalizedCollection = `/${segments[0]}`\n\n    // Check for collision if this is a root entity\n    if (this.isRoot) {\n      const collision = this.api.findCollectionPathCollision(normalizedCollection, this.key)\n      if (collision) {\n        throw new Error(`Collection path \"${normalizedCollection}\" is already in use by another root entity.`)\n      }\n    }\n\n    // Preserve current parameter name if present, otherwise default to {id}\n    let param = '{id}'\n    if (this.resourcePath) {\n      const curSegments = this.resourcePath.split('/').filter(Boolean)\n      const maybeParam = curSegments[1]\n      if (maybeParam && /^\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(maybeParam)) {\n        param = maybeParam\n      }\n    }\n    const nextResource = `${normalizedCollection}/${param}`\n    this.collectionPath = normalizedCollection\n    this.resourcePath = nextResource\n    // rely on ApiModel.exposes deep observation to notify on property sets\n  }\n\n  /**\n   * Sets a new resource path for this exposed entity.\n   *\n   * Rules:\n   * - Must start with '/'.\n   * - If this exposure has a collection, the path must be exactly the collection path plus a single\n   *   parameter segment (e.g. `/products/{productId}`) and only the parameter name may vary.\n   * - If this exposure does NOT have a collection, the path can be any two segments (e.g. `/profile/{id}` or `/a/b`).\n   */\n  setResourcePath(path: string) {\n    const cleaned = ensureLeadingSlash(path)\n    const segments = cleaned.split('/').filter(Boolean)\n\n    if (this.hasCollection) {\n      if (!this.collectionPath) {\n        throw new Error('Cannot set resource path: missing collection path for this exposure')\n      }\n      const colSegments = this.collectionPath.split('/').filter(Boolean)\n      if (colSegments.length !== 1) {\n        throw new Error(`Invalid stored collection path \"${this.collectionPath}\"`)\n      }\n      if (segments.length !== 2) {\n        throw new Error(`Resource path must be exactly two segments (collection + parameter). Received: \"${cleaned}\"`)\n      }\n      const [s1, s2] = segments\n      if (s1 !== colSegments[0]) {\n        throw new Error(`Resource path must start with the collection segment \"${colSegments[0]}\". Received: \"${s1}\"`)\n      }\n      // s2 must be a parameter segment {name}\n      if (!/^\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(s2)) {\n        throw new Error(`The second segment must be a parameter in braces, e.g. {id}. Received: \"${s2}\"`)\n      }\n      if (this.resourcePath !== cleaned) {\n        this.resourcePath = `/${s1}/${s2}`\n      }\n      return\n    }\n\n    // No collection: allow any two segments\n    if (segments.length !== 2) {\n      throw new Error(\n        `Resource path must contain exactly two segments when no collection is present. Received: \"${cleaned}\"`\n      )\n    }\n    // Check for collision if this is a root entity (singleton case)\n    if (this.isRoot) {\n      const collision = this.api.findResourcePathCollision(cleaned, this.key)\n      if (collision) {\n        throw new Error(`Resource path \"${cleaned}\" is already in use by another root entity.`)\n      }\n    }\n\n    if (this.resourcePath !== cleaned) {\n      this.resourcePath = `/${segments[0]}/${segments[1]}`\n    }\n  }\n\n  /**\n   * Computes the absolute path for this exposure's resource endpoint by\n   * walking up the exposure tree using `parent.key` until reaching a root exposure.\n   * The absolute path is composed by concatenating each ancestor's resource path\n   * with this exposure's resource path.\n   */\n  getAbsoluteResourcePath(): string {\n    let absolute = ensureLeadingSlash(this.resourcePath)\n    // Traverse parents, always joining with the parent's resource path\n    let parentKey = this.parent?.key\n    while (parentKey) {\n      const parent = this.api.exposes.get(parentKey)\n      if (!parent) break\n      const parentResource = ensureLeadingSlash(parent.resourcePath)\n      absolute = joinPaths(parentResource, absolute)\n      parentKey = parent.parent?.key\n    }\n    return absolute\n  }\n\n  /**\n   * Computes the absolute path for this exposure's collection endpoint (if any)\n   * by walking up the exposure tree using `parent.key` until reaching a root exposure.\n   * The absolute path is composed by concatenating each ancestor's resource path\n   * with this exposure's collection path.\n   * Returns undefined if this exposure has no collection.\n   */\n  getAbsoluteCollectionPath(): string | undefined {\n    if (!this.hasCollection || !this.collectionPath) return undefined\n    let absolute = ensureLeadingSlash(this.collectionPath)\n    // Traverse parents, always joining with the parent's resource path\n    let parentKey = this.parent?.key\n    while (parentKey) {\n      const parent = this.api.exposes.get(parentKey)\n      if (!parent) break\n      const parentResource = ensureLeadingSlash(parent.resourcePath)\n      absolute = joinPaths(parentResource, absolute)\n      parentKey = parent.parent?.key\n    }\n    return absolute\n  }\n\n  /**\n   * Returns all access rules for this exposure, including the ones from all the parents up to the API.\n   */\n  getAllRules(): AccessRule[] {\n    const rules: AccessRule[] = []\n    this.api.accessRule.forEach((rule) => rules.push(rule))\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    let current: ExposedEntity | undefined = this\n    while (current) {\n      if (current.accessRule) {\n        rules.push(...current.accessRule)\n      }\n      current = current.parent ? this.api.exposes.get(current.parent.key) : undefined\n    }\n    return rules\n  }\n\n  /**\n   * Returns all rate limiters for this exposure, including the ones from all the parents up to the API.\n   */\n  getAllRateLimiters(): RateLimitingConfiguration[] {\n    const rateLimiters: RateLimitingConfiguration[] = []\n    if (this.api.rateLimiting) {\n      rateLimiters.push(this.api.rateLimiting)\n    }\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    let current: ExposedEntity | undefined = this\n    while (current) {\n      if (current.rateLimiting) {\n        rateLimiters.push(current.rateLimiting)\n      }\n      current = current.parent ? this.api.exposes.get(current.parent.key) : undefined\n    }\n    return rateLimiters\n  }\n\n  /**\n   * Returns all rate limiter rules for this exposure, including the ones from all the parents up to the API.\n   * Similar to the getAllRules() method, but it flattens the rate limiters into a single list of rules.\n   */\n  getAllRateLimiterRules(): RateLimitRule[] {\n    const rules: RateLimitRule[] = []\n    if (this.api.rateLimiting) {\n      rules.push(...this.api.rateLimiting.rules)\n    }\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    let current: ExposedEntity | undefined = this\n    while (current) {\n      if (current.rateLimiting) {\n        rules.push(...current.rateLimiting.rules)\n      }\n      current = current.parent ? this.api.exposes.get(current.parent.key) : undefined\n    }\n    return rules\n  }\n}\n"]}
+{"version":3,"file":"ExposedEntity.js","sourceRoot":"","sources":["../../../src/modeling/ExposedEntity.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAE5E,OAAO,EAAsB,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAA;AAGhF;;;;;;;;;;;;;GAaG;IACU,aAAa;sBAAS,WAAW;;;;;;;;;;;;;;;;;;;iBAAjC,aAAc,SAAQ,WAAW;;;kCAe3C,QAAQ,EAAE;0CAeV,QAAQ,EAAE;wCAMV,QAAQ,EAAE;mCA4BV,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;sCAKxB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;wCAKxB,QAAQ,EAAE;YA3DC,uKAAS,MAAM,6BAAN,MAAM,uFAAmB;YAelC,+LAAS,cAAc,6BAAd,cAAc,uGAAoB;YAM3C,yLAAS,YAAY,6BAAZ,YAAY,mGAAQ;YA4Bf,0KAAS,OAAO,6BAAP,OAAO,yFAAU;YAK1B,mLAAS,UAAU,6BAAV,UAAU,+FAA0B;YAK3D,yLAAS,YAAY,6BAAZ,YAAY,mGAAuC;;;QAzExE;;WAEG;QACH,IAAI,CAA0B;QAE9B;;;WAGG;QACH,GAAG,CAAQ;QAKC,iFAAkC;QAH9C;;WAEG;QACS,IAAS,MAAM,4CAAmB;QAAlC,IAAS,MAAM,kDAAmB;QAE9C;;;;;;WAMG;QACH,aAAa,sDAAS;QAMV,iGAA2C;QAJvD;;;WAGG;QACS,IAAS,cAAc,oDAAoB;QAA3C,IAAS,cAAc,0DAAoB;QAM3C,2JAA6B;QAJzC;;;WAGG;QACS,IAAS,YAAY,kDAAQ;QAA7B,IAAS,YAAY,wDAAQ;QAEzC;;;;;WAKG;QACH,MAAM,4DAAU;QAEhB;;;;WAIG;QACH,MAAM,CAAkB;QAExB;;;;;WAKG;QACH,aAAa,CAAgB;QAKH,mFAA0B;QAHpD;;WAEG;QACuB,IAAS,OAAO,6CAAU;QAA1B,IAAS,OAAO,mDAAU;QAK1B,gJAA6C;QAHvE;;WAEG;QACuB,IAAS,UAAU,gDAA0B;QAA7C,IAAS,UAAU,sDAA0B;QAK3D,uJAA4D;QAHxE;;WAEG;QACS,IAAS,YAAY,kDAAuC;QAA5D,IAAS,YAAY,wDAAuC;QAExE;;;;WAIG;QACH,SAAS,4DAAU;QAEnB;;;;;WAKG;QACH,UAAU,GAAG,KAAK,CAAA;QAClB;;;WAGG;QACH,aAAa,GAAG,IAAI,CAAA;QACpB;;WAEG;QACH,GAAG,CAAU;QAEb,MAAM,CAAC,YAAY,CAAC,QAAsC,EAAE;YAC1D,MAAM,EACJ,GAAG,GAAG,MAAM,EAAE,EACd,MAAM,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EACpB,cAAc,EACd,YAAY,GAAG,GAAG,EAClB,aAAa,GAAG,IAAI,EACpB,MAAM,EACN,MAAM,EACN,aAAa,EACb,OAAO,GAAG,EAAE,EACZ,UAAU,EACV,YAAY,EACZ,SAAS,GACV,GAAG,KAAK,CAAA;YACT,MAAM,MAAM,GAAwB;gBAClC,IAAI,EAAE,iBAAiB;gBACvB,GAAG;gBACH,MAAM,EAAE,EAAE,GAAG,MAAM,EAAE;gBACrB,aAAa;gBACb,YAAY;gBACZ,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;aACxC,CAAA;YACD,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,CAAC,cAAc,GAAG,cAAc,CAAA;YACxC,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;YACxB,CAAC;YACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;YAC/B,CAAC;YACD,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;gBAChC,MAAM,CAAC,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,CAAA;YAC7C,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;YACzD,CAAC;YACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;gBAC/B,MAAM,CAAC,YAAY,GAAG,EAAE,GAAG,YAAY,EAAE,CAAA;YAC3C,CAAC;YACD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,MAAM,CAAC,SAAS,GAAG,SAAS,CAAA;YAC9B,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,YAAY,KAAe,EAAE,KAAoC;YAC/D,KAAK,EAAE,CAAA;YACP,IAAI,CAAC,GAAG,GAAG,KAAK,CAAA;YAChB,MAAM,IAAI,GAAG,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;YAC9C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;YACrB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;YACnB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;YACzB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAA;YACvC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAA;YACzC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAA;YACrC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;YACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;YACzB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAA;YACvC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAClF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,iBAAiB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAC3F,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACpG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;YAC/B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;QAC5B,CAAC;QAED,YAAY;YACV,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC1C,OAAM;YACR,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;YACtB,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;gBACvB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAA;gBACjC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;YAC3B,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,MAAM;YACJ,MAAM,MAAM,GAAwB;gBAClC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE;gBAC1B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;gBAC5C,aAAa,EAAE,IAAI,CAAC,aAAa;aAClC,CAAA;YACD,IAAI,IAAI,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;gBACtC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAA;YAC7C,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;YAC7B,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;YACpC,CAAC;YACD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBACrC,MAAM,CAAC,aAAa,GAAG,EAAE,GAAG,IAAI,CAAC,aAAa,EAAE,CAAA;YAClD,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjE,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,CAAA;YAC9D,CAAC;YACD,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAA;YAClD,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;gBACjC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAA;YACnC,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED;;;;;;;;WAQG;QACH,iBAAiB,CAAC,IAAY;YAC5B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,2EAA2E,CAAC,CAAA;YAC9F,CAAC;YACD,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;YACxC,uCAAuC;YACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YACnD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CAAC,gEAAgE,IAAI,GAAG,CAAC,CAAA;YAC1F,CAAC;YACD,MAAM,oBAAoB,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;YAE9C,+CAA+C;YAC/C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,2BAA2B,CAAC,oBAAoB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;gBACtF,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CAAC,oBAAoB,oBAAoB,6CAA6C,CAAC,CAAA;gBACxG,CAAC;YACH,CAAC;YAED,wEAAwE;YACxE,IAAI,KAAK,GAAG,MAAM,CAAA;YAClB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBAChE,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;gBACjC,IAAI,UAAU,IAAI,8BAA8B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;oBAClE,KAAK,GAAG,UAAU,CAAA;gBACpB,CAAC;YACH,CAAC;YACD,MAAM,YAAY,GAAG,GAAG,oBAAoB,IAAI,KAAK,EAAE,CAAA;YACvD,IAAI,CAAC,cAAc,GAAG,oBAAoB,CAAA;YAC1C,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;YAChC,uEAAuE;QACzE,CAAC;QAED;;;;;;;;WAQG;QACH,eAAe,CAAC,IAAY;YAC1B,MAAM,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAA;YACxC,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAEnD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;oBACzB,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAA;gBACxF,CAAC;gBACD,MAAM,WAAW,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;gBAClE,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC7B,MAAM,IAAI,KAAK,CAAC,mCAAmC,IAAI,CAAC,cAAc,GAAG,CAAC,CAAA;gBAC5E,CAAC;gBACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC1B,MAAM,IAAI,KAAK,CAAC,mFAAmF,OAAO,GAAG,CAAC,CAAA;gBAChH,CAAC;gBACD,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,QAAQ,CAAA;gBACzB,IAAI,EAAE,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC1B,MAAM,IAAI,KAAK,CAAC,yDAAyD,WAAW,CAAC,CAAC,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAA;gBAChH,CAAC;gBACD,wCAAwC;gBACxC,IAAI,CAAC,8BAA8B,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC7C,MAAM,IAAI,KAAK,CAAC,2EAA2E,EAAE,GAAG,CAAC,CAAA;gBACnG,CAAC;gBACD,IAAI,IAAI,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;oBAClC,IAAI,CAAC,YAAY,GAAG,IAAI,EAAE,IAAI,EAAE,EAAE,CAAA;gBACpC,CAAC;gBACD,OAAM;YACR,CAAC;YAED,2CAA2C;YAC3C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,IAAI,KAAK,CACb,4FAA4F,OAAO,GAAG,CACvG,CAAA;YACH,CAAC;YACD,gEAAgE;YAChE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAChB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;gBACvE,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,IAAI,KAAK,CAAC,kBAAkB,OAAO,6CAA6C,CAAC,CAAA;gBACzF,CAAC;YACH,CAAC;YAED,IAAI,IAAI,CAAC,YAAY,KAAK,OAAO,EAAE,CAAC;gBAClC,IAAI,CAAC,YAAY,GAAG,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAA;YACvC,CAAC;QACH,CAAC;QAED;;;;;WAKG;QACH,uBAAuB;YACrB,IAAI,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;YACpD,mEAAmE;YACnE,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAA;YAChC,OAAO,SAAS,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;gBAC9C,IAAI,CAAC,MAAM;oBAAE,MAAK;gBAClB,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;gBAC9D,QAAQ,GAAG,SAAS,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;gBAC9C,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAA;YAChC,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED;;;;;;WAMG;QACH,yBAAyB;YACvB,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,cAAc;gBAAE,OAAO,SAAS,CAAA;YACjE,IAAI,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YACtD,mEAAmE;YACnE,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,CAAA;YAChC,OAAO,SAAS,EAAE,CAAC;gBACjB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;gBAC9C,IAAI,CAAC,MAAM;oBAAE,MAAK;gBAClB,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;gBAC9D,QAAQ,GAAG,SAAS,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAA;gBAC9C,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAA;YAChC,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED;;WAEG;QACH,WAAW;YACT,MAAM,KAAK,GAAiB,EAAE,CAAA;YAC9B,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;YACvD,4DAA4D;YAC5D,IAAI,OAAO,GAA8B,IAAI,CAAA;YAC7C,OAAO,OAAO,EAAE,CAAC;gBACf,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;oBACvB,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;gBACnC,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACjF,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QAED;;WAEG;QACH,kBAAkB;YAChB,MAAM,YAAY,GAAgC,EAAE,CAAA;YACpD,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;gBAC1B,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAA;YAC1C,CAAC;YACD,4DAA4D;YAC5D,IAAI,OAAO,GAA8B,IAAI,CAAA;YAC7C,OAAO,OAAO,EAAE,CAAC;gBACf,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;oBACzB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAA;gBACzC,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACjF,CAAC;YACD,OAAO,YAAY,CAAA;QACrB,CAAC;QAED;;;WAGG;QACH,sBAAsB;YACpB,MAAM,KAAK,GAAoB,EAAE,CAAA;YACjC,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;YAC5C,CAAC;YACD,4DAA4D;YAC5D,IAAI,OAAO,GAA8B,IAAI,CAAA;YAC7C,OAAO,OAAO,EAAE,CAAC;gBACf,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;oBACzB,KAAK,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;gBAC3C,CAAC;gBACD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YACjF,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;;;SAzZU,aAAa","sourcesContent":["import { observed } from '../decorators/observed.js'\nimport { ExposedEntityKind } from '../models/kinds.js'\nimport { nanoid } from '../nanoid.js'\nimport { Action } from './actions/Action.js'\nimport { restoreAction } from './actions/index.js'\nimport type { ApiModel } from './ApiModel.js'\nimport { ensureLeadingSlash, joinPaths } from './helpers/endpointHelpers.js'\nimport { AccessRule } from './rules/AccessRule.js'\nimport { type RateLimitRule, restoreAccessRule } from './rules/index.js'\nimport { RateLimitingConfiguration } from './rules/RateLimitingConfiguration.js'\nimport type { AssociationTarget, ExposeOptions, ExposeParentRef, ExposedEntitySchema } from './types.js'\n\n/**\n * A class that specializes in representing an exposed Data Entity within an API Model.\n *\n * ## Design Note\n * This class enforces strict path constraints (e.g., single-segment collection paths like `/users`,\n * two-segment resource paths like `/users/{id}`).\n * This is an intentional design choice to support a UI paradigm for non-technical users, ensuring that\n * path segments are configured individually at each level of the exposure hierarchy.\n *\n * Flexibility is achieved by chaining exposed entities (parent/child relationships), where the final\n * absolute path is composed of all ancestral paths. See `getAbsoluteResourcePath()` and `getAbsoluteCollectionPath()`.\n *\n * @fires change - Emitted when the exposed entity has changed.\n */\nexport class ExposedEntity extends EventTarget {\n  /**\n   * The exposed entity kind recognizable by the ecosystem.\n   */\n  kind: typeof ExposedEntityKind\n\n  /**\n   * The unique key of the exposed entity.\n   * This is a stable identifier that does not change across versions.\n   */\n  key: string\n\n  /**\n   * A pointer to a Data Entity from the Data Domain.\n   */\n  @observed() accessor entity: AssociationTarget\n\n  /**\n   * Indicates whether this exposure has a collection endpoint.\n   * A collection endpoint is optional for nested exposures where the association is 1:1\n   * and the schema is embedded directly under the parent resource.\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  hasCollection: boolean\n\n  /**\n   * Path to the collection endpoint for this exposure.\n   * Starts with '/'. Not set for 1:1 nested exposures where collection does not exist.\n   */\n  @observed() accessor collectionPath: string | undefined\n\n  /**\n   * Path to the resource endpoint for this exposure.\n   * Starts with '/'. For 1:1 nested exposures the resource path typically does not include an id segment.\n   */\n  @observed() accessor resourcePath: string\n\n  /**\n   * Whether this exposure is a root exposure (top-level collection).\n   * If this is set then the `parent` reference must be populated.\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  isRoot?: boolean\n\n  /**\n   * Parent reference when this exposure was created via following an association.\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  parent?: ExposeParentRef\n\n  /**\n   * Expose-time config used to create this exposure (persisted for auditing/UI).\n   * This is only populated for the root exposure. All children exposures inherit this config.\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  exposeOptions?: ExposeOptions\n\n  /**\n   * The list of enabled API actions for this exposure (List/Read/Create/etc.)\n   */\n  @observed({ deep: true }) accessor actions: Action[]\n\n  /**\n   * Optional array of access rules that define the access control policies for this exposure.\n   */\n  @observed({ deep: true }) accessor accessRule: AccessRule[] | undefined\n\n  /**\n   * Optional configuration for rate limiting for this exposure.\n   */\n  @observed() accessor rateLimiting: RateLimitingConfiguration | undefined\n\n  /**\n   * When true, generation for this exposure hit configured limits\n   *\n   * Note that this property is not observed for changes as it is immutable after creation.\n   */\n  truncated?: boolean\n\n  /**\n   * When the notifying flag is set to true,\n   * the domain is pending a notification.\n   * No other notifications will be sent until\n   * the current notification is sent.\n   */\n  #notifying = false\n  /**\n   * When the initializing flag is set to true,\n   * the domain is not notified of changes.\n   */\n  #initializing = true\n  /**\n   * A reference to the parent API Model instance.\n   */\n  api: ApiModel\n\n  static createSchema(input: Partial<ExposedEntitySchema> = {}): ExposedEntitySchema {\n    const {\n      key = nanoid(),\n      entity = { key: '' },\n      collectionPath,\n      resourcePath = '/',\n      hasCollection = true,\n      isRoot,\n      parent,\n      exposeOptions,\n      actions = [],\n      accessRule,\n      rateLimiting,\n      truncated,\n    } = input\n    const result: ExposedEntitySchema = {\n      kind: ExposedEntityKind,\n      key,\n      entity: { ...entity },\n      hasCollection,\n      resourcePath,\n      actions: actions.map((a) => ({ ...a })),\n    }\n    if (collectionPath !== undefined) {\n      result.collectionPath = collectionPath\n    }\n    if (isRoot !== undefined) {\n      result.isRoot = isRoot\n    }\n    if (parent !== undefined) {\n      result.parent = { ...parent }\n    }\n    if (exposeOptions !== undefined) {\n      result.exposeOptions = { ...exposeOptions }\n    }\n    if (Array.isArray(accessRule)) {\n      result.accessRule = accessRule.map((ar) => ({ ...ar }))\n    }\n    if (rateLimiting !== undefined) {\n      result.rateLimiting = { ...rateLimiting }\n    }\n    if (truncated !== undefined) {\n      result.truncated = truncated\n    }\n    return result\n  }\n\n  constructor(model: ApiModel, state?: Partial<ExposedEntitySchema>) {\n    super()\n    this.api = model\n    const init = ExposedEntity.createSchema(state)\n    this.kind = init.kind\n    this.key = init.key\n    this.entity = init.entity\n    this.hasCollection = init.hasCollection\n    this.collectionPath = init.collectionPath\n    this.resourcePath = init.resourcePath\n    this.isRoot = init.isRoot\n    this.parent = init.parent\n    this.exposeOptions = init.exposeOptions\n    this.actions = init.actions ? init.actions.map((a) => restoreAction(this, a)) : []\n    this.accessRule = init.accessRule ? init.accessRule.map((ar) => restoreAccessRule(ar)) : []\n    this.rateLimiting = init.rateLimiting ? new RateLimitingConfiguration(init.rateLimiting) : undefined\n    this.truncated = init.truncated\n    this.#initializing = false\n  }\n\n  notifyChange() {\n    if (this.#notifying || this.#initializing) {\n      return\n    }\n    this.#notifying = true\n    queueMicrotask(() => {\n      this.#notifying = false\n      const event = new Event('change')\n      this.dispatchEvent(event)\n    })\n  }\n\n  toJSON(): ExposedEntitySchema {\n    const result: ExposedEntitySchema = {\n      kind: this.kind,\n      key: this.key,\n      entity: { ...this.entity },\n      resourcePath: this.resourcePath,\n      actions: this.actions.map((a) => a.toJSON()),\n      hasCollection: this.hasCollection,\n    }\n    if (this.collectionPath !== undefined) {\n      result.collectionPath = this.collectionPath\n    }\n    if (this.isRoot !== undefined) {\n      result.isRoot = this.isRoot\n    }\n    if (this.parent !== undefined) {\n      result.parent = { ...this.parent }\n    }\n    if (this.exposeOptions !== undefined) {\n      result.exposeOptions = { ...this.exposeOptions }\n    }\n    if (Array.isArray(this.accessRule) && this.accessRule.length > 0) {\n      result.accessRule = this.accessRule.map((ar) => ar.toJSON())\n    }\n    if (this.rateLimiting !== undefined) {\n      result.rateLimiting = this.rateLimiting.toJSON()\n    }\n    if (this.truncated !== undefined) {\n      result.truncated = this.truncated\n    }\n    return result\n  }\n\n  /**\n   * Sets a new collection path for this exposed entity.\n   *\n   * It:\n   * - updates the collectionPath property\n   * - updates the absoluteCollectionPath property accordingly\n   * - updates the resourcePath accordingly.\n   * @param path The new path to set.\n   */\n  setCollectionPath(path: string) {\n    if (!this.hasCollection) {\n      throw new Error(`Cannot set collection path on an exposure that does not have a collection`)\n    }\n    const cleaned = ensureLeadingSlash(path)\n    // Ensure exactly one non-empty segment\n    const segments = cleaned.split('/').filter(Boolean)\n    if (segments.length !== 1) {\n      throw new Error(`Collection path must contain exactly one segment. Received: \"${path}\"`)\n    }\n    const normalizedCollection = `/${segments[0]}`\n\n    // Check for collision if this is a root entity\n    if (this.isRoot) {\n      const collision = this.api.findCollectionPathCollision(normalizedCollection, this.key)\n      if (collision) {\n        throw new Error(`Collection path \"${normalizedCollection}\" is already in use by another root entity.`)\n      }\n    }\n\n    // Preserve current parameter name if present, otherwise default to {id}\n    let param = '{id}'\n    if (this.resourcePath) {\n      const curSegments = this.resourcePath.split('/').filter(Boolean)\n      const maybeParam = curSegments[1]\n      if (maybeParam && /^\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(maybeParam)) {\n        param = maybeParam\n      }\n    }\n    const nextResource = `${normalizedCollection}/${param}`\n    this.collectionPath = normalizedCollection\n    this.resourcePath = nextResource\n    // rely on ApiModel.exposes deep observation to notify on property sets\n  }\n\n  /**\n   * Sets a new resource path for this exposed entity.\n   *\n   * Rules:\n   * - Must start with '/'.\n   * - If this exposure has a collection, the path must be exactly the collection path plus a single\n   *   parameter segment (e.g. `/products/{productId}`) and only the parameter name may vary.\n   * - If this exposure does NOT have a collection, the path can be any two segments (e.g. `/profile/{id}` or `/a/b`).\n   */\n  setResourcePath(path: string) {\n    const cleaned = ensureLeadingSlash(path)\n    const segments = cleaned.split('/').filter(Boolean)\n\n    if (this.hasCollection) {\n      if (!this.collectionPath) {\n        throw new Error('Cannot set resource path: missing collection path for this exposure')\n      }\n      const colSegments = this.collectionPath.split('/').filter(Boolean)\n      if (colSegments.length !== 1) {\n        throw new Error(`Invalid stored collection path \"${this.collectionPath}\"`)\n      }\n      if (segments.length !== 2) {\n        throw new Error(`Resource path must be exactly two segments (collection + parameter). Received: \"${cleaned}\"`)\n      }\n      const [s1, s2] = segments\n      if (s1 !== colSegments[0]) {\n        throw new Error(`Resource path must start with the collection segment \"${colSegments[0]}\". Received: \"${s1}\"`)\n      }\n      // s2 must be a parameter segment {name}\n      if (!/^\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(s2)) {\n        throw new Error(`The second segment must be a parameter in braces, e.g. {id}. Received: \"${s2}\"`)\n      }\n      if (this.resourcePath !== cleaned) {\n        this.resourcePath = `/${s1}/${s2}`\n      }\n      return\n    }\n\n    // No collection: allow exactly one segment\n    if (segments.length !== 1) {\n      throw new Error(\n        `Resource path must contain exactly one segment when no collection is present. Received: \"${cleaned}\"`\n      )\n    }\n    // Check for collision if this is a root entity (singleton case)\n    if (this.isRoot) {\n      const collision = this.api.findResourcePathCollision(cleaned, this.key)\n      if (collision) {\n        throw new Error(`Resource path \"${cleaned}\" is already in use by another root entity.`)\n      }\n    }\n\n    if (this.resourcePath !== cleaned) {\n      this.resourcePath = `/${segments[0]}`\n    }\n  }\n\n  /**\n   * Computes the absolute path for this exposure's resource endpoint by\n   * walking up the exposure tree using `parent.key` until reaching a root exposure.\n   * The absolute path is composed by concatenating each ancestor's resource path\n   * with this exposure's resource path.\n   */\n  getAbsoluteResourcePath(): string {\n    let absolute = ensureLeadingSlash(this.resourcePath)\n    // Traverse parents, always joining with the parent's resource path\n    let parentKey = this.parent?.key\n    while (parentKey) {\n      const parent = this.api.exposes.get(parentKey)\n      if (!parent) break\n      const parentResource = ensureLeadingSlash(parent.resourcePath)\n      absolute = joinPaths(parentResource, absolute)\n      parentKey = parent.parent?.key\n    }\n    return absolute\n  }\n\n  /**\n   * Computes the absolute path for this exposure's collection endpoint (if any)\n   * by walking up the exposure tree using `parent.key` until reaching a root exposure.\n   * The absolute path is composed by concatenating each ancestor's resource path\n   * with this exposure's collection path.\n   * Returns undefined if this exposure has no collection.\n   */\n  getAbsoluteCollectionPath(): string | undefined {\n    if (!this.hasCollection || !this.collectionPath) return undefined\n    let absolute = ensureLeadingSlash(this.collectionPath)\n    // Traverse parents, always joining with the parent's resource path\n    let parentKey = this.parent?.key\n    while (parentKey) {\n      const parent = this.api.exposes.get(parentKey)\n      if (!parent) break\n      const parentResource = ensureLeadingSlash(parent.resourcePath)\n      absolute = joinPaths(parentResource, absolute)\n      parentKey = parent.parent?.key\n    }\n    return absolute\n  }\n\n  /**\n   * Returns all access rules for this exposure, including the ones from all the parents up to the API.\n   */\n  getAllRules(): AccessRule[] {\n    const rules: AccessRule[] = []\n    this.api.accessRule.forEach((rule) => rules.push(rule))\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    let current: ExposedEntity | undefined = this\n    while (current) {\n      if (current.accessRule) {\n        rules.push(...current.accessRule)\n      }\n      current = current.parent ? this.api.exposes.get(current.parent.key) : undefined\n    }\n    return rules\n  }\n\n  /**\n   * Returns all rate limiters for this exposure, including the ones from all the parents up to the API.\n   */\n  getAllRateLimiters(): RateLimitingConfiguration[] {\n    const rateLimiters: RateLimitingConfiguration[] = []\n    if (this.api.rateLimiting) {\n      rateLimiters.push(this.api.rateLimiting)\n    }\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    let current: ExposedEntity | undefined = this\n    while (current) {\n      if (current.rateLimiting) {\n        rateLimiters.push(current.rateLimiting)\n      }\n      current = current.parent ? this.api.exposes.get(current.parent.key) : undefined\n    }\n    return rateLimiters\n  }\n\n  /**\n   * Returns all rate limiter rules for this exposure, including the ones from all the parents up to the API.\n   * Similar to the getAllRules() method, but it flattens the rate limiters into a single list of rules.\n   */\n  getAllRateLimiterRules(): RateLimitRule[] {\n    const rules: RateLimitRule[] = []\n    if (this.api.rateLimiting) {\n      rules.push(...this.api.rateLimiting.rules)\n    }\n    // eslint-disable-next-line @typescript-eslint/no-this-alias\n    let current: ExposedEntity | undefined = this\n    while (current) {\n      if (current.rateLimiting) {\n        rules.push(...current.rateLimiting.rules)\n      }\n      current = current.parent ? this.api.exposes.get(current.parent.key) : undefined\n    }\n    return rules\n  }\n}\n"]}

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

@@ -1,7 +1,7 @@
 import type { ApiModel } from '../ApiModel.js';
 import type { ExposedEntity } from '../ExposedEntity.js';
 import type { Action } from '../actions/Action.js';
-import type { ApiModelValidationItem, ApiModelValidationResult } from '../types.js';
+import type { ApiModelValidationItem } from '../types.js';
 /**
  * Validates the core properties and metadata of an ApiModel.
  */
@@ -11,5 +11,4 @@ export declare function validateApiModelSecurity(model: ApiModel): ApiModelValid
 export declare function validateApiModelMetadata(model: ApiModel): ApiModelValidationItem[];
 export declare function validateAction(action: Action, parent: ExposedEntity, apiModelKey: string): ApiModelValidationItem[];
 export declare function validateExposedEntity(entity: ExposedEntity, apiModel: ApiModel): ApiModelValidationItem[];
-export declare function validateApiModel(model: ApiModel): ApiModelValidationResult;
 //# sourceMappingURL=api_model_rules.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"api_model_rules.d.ts","sourceRoot":"","sources":["../../../../src/modeling/validation/api_model_rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAMlD,OAAO,KAAK,EAAE,sBAAsB,EAAE,wBAAwB,EAA6B,MAAM,aAAa,CAAA;AAa9G;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAiD9E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CA+BpF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAuKlF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAuElF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,sBAAsB,EAAE,CA2FnH;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAsKzG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,wBAAwB,CA4B1E"}
+{"version":3,"file":"api_model_rules.d.ts","sourceRoot":"","sources":["../../../../src/modeling/validation/api_model_rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAMlD,OAAO,KAAK,EAAE,sBAAsB,EAA6B,MAAM,aAAa,CAAA;AAapF;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAiD9E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CA+BpF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAuKlF;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAuElF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,GAAG,sBAAsB,EAAE,CA2FnH;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,GAAG,sBAAsB,EAAE,CAsKzG"}

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

@@ -488,11 +488,11 @@ export function validateExposedEntity(entity, apiModel) {
         }
         else {
             const parts = entity.resourcePath.split('/').filter(Boolean);
-            if (parts.length !== 2 || !entity.resourcePath.startsWith('/')) {
+            if (parts.length !== 1 || !entity.resourcePath.startsWith('/')) {
                 issues.push({
                     code: createCode('EXPOSURE', 'INVALID_RESOURCE_PATH_FORMAT'),
-                    message: 'The URL route must only contain two exact parts or levels.',
-                    suggestion: 'Simplify the endpoint URL to prevent deep-nesting.',
+                    message: 'The URL route must only contain one exact part or level.',
+                    suggestion: 'Simplify the endpoint URL to a single segment.',
                     severity: 'error',
                     context: { ...context, property: 'resourcePath' },
                 });
@@ -570,30 +570,4 @@ export function validateExposedEntity(entity, apiModel) {
     }
     return issues;
 }
-export function validateApiModel(model) {
-    const issues = [];
-    issues.push(...validateApiModelInfo(model));
-    issues.push(...validateApiModelDependency(model));
-    issues.push(...validateApiModelSecurity(model));
-    issues.push(...validateApiModelMetadata(model));
-    if (!model.exposes || model.exposes.size === 0) {
-        issues.push({
-            code: createCode('API', 'NO_EXPOSURES'),
-            message: 'Your API currently has no exposed data for external clients to request.',
-            suggestion: 'Expose a data model so apps can communicate with it.',
-            severity: 'warning',
-            context: { apiModelKey: model.key, kind: ApiModelKind, key: model.key, property: 'exposes' },
-        });
-    }
-    else {
-        for (const exposure of model.exposes.values()) {
-            issues.push(...validateExposedEntity(exposure, model));
-        }
-    }
-    const hasErrors = issues.some((i) => i.severity === 'error');
-    return {
-        isValid: !hasErrors,
-        issues,
-    };
-}
 //# sourceMappingURL=api_model_rules.js.map