@api-client/core 0.19.23 → 0.19.25

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

@@ -1 +1 @@
-{"version":3,"file":"DomainEntity.js","sourceRoot":"","sources":["../../../src/modeling/DomainEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DataDomain } from './DataDomain.js'\nimport { DomainAssociationKind, DomainEntityKind, DomainPropertyKind } from '../models/kinds.js'\nimport { DomainElement, type DomainElementSchema } from './DomainElement.js'\nimport { nanoid } from '../nanoid.js'\nimport { type ThingSchema, Thing } from '../models/Thing.js'\nimport { observed, retargetChange, toRaw } from '../decorators/observed.js'\nimport type { Shapes, IShapeRenderOptions } from '@api-client/amf-core'\nimport { ApiSchemaGenerator } from '@api-client/amf-core'\nimport { DomainProperty, type DomainPropertySchema } from './DomainProperty.js'\nimport { RemovePropertyException } from '../exceptions/remove_property_exception.js'\nimport { DomainAssociation, DomainAssociationSchema } from './DomainAssociation.js'\nimport type { FileBreadcrumb } from '../models/store/File.js'\nimport type { DomainModel } from './DomainModel.js'\nimport type { DomainNamespace } from './DomainNamespace.js'\nimport { ValidationError } from '../exceptions/validation_error.js'\nimport { ShapeGenerator } from './amf/ShapeGenerator.js'\nimport { removeGraphNode } from './GraphUtils.js'\nimport { DataSemantics, isEntitySemantic, type SemanticType, type AppliedDataSemantic } from './Semantics.js'\n\nexport interface EntityOrderedItem {\n  /**\n   * The type of the ordered item.\n   */\n  type: 'property' | 'association'\n\n  /**\n   * The key of the ordered item.\n   */\n  key: string\n}\n\nexport interface DomainEntitySchema extends DomainElementSchema {\n  kind: typeof DomainEntityKind\n  /**\n   * The domain entity description.\n   */\n  info: ThingSchema\n\n  /**\n   * Optional general purpose tags for the UI.\n   */\n  tags?: string[]\n\n  /**\n   * The semantics applied to this entity.\n   * This is a list of applied semantics that can be used to\n   * describe the entity in more detail.\n   */\n  semantics?: AppliedDataSemantic[]\n\n  /**\n   * The ordered list of fields (properties and associations) in the schema.\n   * These only keep references to the properties and associations.\n   * The order of the fields is important as it defines the order of the\n   * properties in the schema.\n   */\n  fields?: EntityOrderedItem[]\n\n  /**\n   * Whether this entity is deprecated.\n   */\n  deprecated?: boolean\n}\n\n/**\n * Represents an entity within a data domain model.\n *\n * A `DomainEntity` defines a structured data type,\n * containing properties and associations. It's a\n * fundamental building block for modeling complex data\n * structures.\n *\n * **Key Features:**\n *\n * - **Properties:** Defines the data elements (fields) within the entity.\n * - **Associations:** Defines relationships to other entities.\n * - **Inheritance:** Supports inheriting properties and associations from parent entities.\n * - **Metadata:** Supports tags, semantics, and deprecation status.\n * - **AMF Shape Generation:** Can be serialized to an AMF (API Modeling Framework) shape.\n * - **Example Generation:** Can generate example databased on its schema.\n *\n * **Usage:**\n *\n * The preferred way to create a `DomainEntity` is through\n * the `DomainModel.addEntity()` method.\n *\n * **Example:**\n *\n * ```typescript\n * const dataDomain = new DataDomain();\n * const userModel = dataDomain.addModel({ key: 'userModel' });\n * const userEntity = userModel.addEntity({ key: 'user' });\n * ```\n *\n * Entity Validation Rules:\n *\n * - **Primary Key:** An entity must have a primary key selected. This can come from a parent\n *   entity or be defined in the current entity.\n * - **Parent Entity:** The parent entity must exist in the graph.\n * - **Circular Dependency:** Adding a parent entity that creates a circular dependency is not allowed.\n * - **Unique Parent:** An entity cannot have the same parent more than once.\n * - **Property Shadowing:** A property can shadow a parent property. This means that if a property\n *   with the same key exists in both the parent and child entity, the child property will take precedence.\n * - **Association Shadowing:** An association can shadow a parent association. This means that if an\n *   association with the same key exists in both the parent and child entity,\n *   the child association will take precedence.\n * - **Property Resolution:** When the same property exists more than one parent and the child entity,\n *   doesn't explicitly define the property, then:\n *   - The last parent entity (iterating from the first entity to the last) that has the property\n *     will be used as the source of the property.\n * - **Association Resolution:** When the same association exists more than one parent and the child entity,\n *   doesn't explicitly define the association, then:\n *   - The last parent entity (iterating from the first entity to the last) that has the association\n *     will be used as the source of the association.\n * - **Minimum Required Properties:** An entity must have at least one property defined. Entities without properties\n *   are ignored in the system.\n * - **Entity Name**:\n *   - An entity must have a name defined.\n *   - The name has to follow the same rules as the names in a SQL database. This means that the name must be unique\n *     within the data domain and cannot contain special characters.\n * - **Association Targets:** An association must have a target entity defined.\n *   This means that the association must point to at least one entity.\n */\nexport class DomainEntity extends DomainElement {\n  /**\n   * The kind of the domain element.\n   */\n  override kind: typeof DomainEntityKind\n\n  /**\n   * The description of the domain entity.\n   */\n  @retargetChange() accessor info: Thing\n\n  /**\n   * Optional general purpose tags for the UI.\n   */\n  @observed({ deep: true }) accessor tags: string[]\n\n  /**\n   * Semantics applied to this property.\n   */\n  @observed({ deep: true }) accessor semantics: AppliedDataSemantic[] = []\n\n  /**\n   * The ordered list of fields (properties and associations) in the schema.\n   * These only keep references to the properties and associations.\n   * The order of the fields is important as it defines the order of the\n   * properties in the schema.\n   */\n  accessor fields: EntityOrderedItem[]\n\n  /**\n   * Whether this entity is deprecated.\n   */\n  @observed() accessor deprecated: boolean | undefined\n\n  /**\n   * Creates a full data entity schema with defaults.\n   *\n   * @param input The partial data entity schema.\n   * @returns The data entity schema.\n   */\n  static createSchema(input: Partial<DomainEntitySchema> = {}): DomainEntitySchema {\n    const { key = nanoid(), tags, semantics, fields, deprecated } = input\n    const info = Thing.fromJSON(input.info, { name: 'new_entity' }).toJSON()\n    const result: DomainEntitySchema = {\n      kind: DomainEntityKind,\n      key,\n      info,\n    }\n    if (Array.isArray(tags)) {\n      result.tags = [...tags]\n    }\n    if (Array.isArray(semantics)) {\n      result.semantics = [...semantics]\n    }\n    if (Array.isArray(fields)) {\n      result.fields = [...fields]\n    }\n    if (typeof deprecated === 'boolean') {\n      result.deprecated = deprecated\n    }\n    return result\n  }\n\n  /**\n   * Creates a new domain entity instance.\n   *\n   * You probably want to use the `DomainModel.addEntity()`\n   * method instead.\n   *\n   * @param root A reference to the root DataDomain instance.\n   * @param input The partial domain entity schema.\n   */\n  constructor(root: DataDomain, input?: Partial<DomainEntitySchema>) {\n    const init = DomainEntity.createSchema(input)\n    super(root, init.key)\n    this.kind = DomainEntityKind\n    this.info = new Thing(init.info)\n    if (Array.isArray(init.tags)) {\n      this.tags = [...init.tags]\n    } else {\n      this.tags = []\n    }\n    if (Array.isArray(init.semantics)) {\n      this.semantics = init.semantics.map((item) => structuredClone(item))\n    } else {\n      this.semantics = []\n    }\n    if (Array.isArray(init.fields)) {\n      this.fields = [...init.fields]\n    } else {\n      this.fields = []\n    }\n    if (typeof init.deprecated === 'boolean') {\n      this.deprecated = init.deprecated\n    }\n  }\n\n  /**\n   * Generates a JSON representation of the entity.\n   *\n   * @returns A plain object representation of the `DomainEntity`.\n   */\n  toJSON(): DomainEntitySchema {\n    const result: DomainEntitySchema = {\n      kind: this.kind,\n      key: this.key,\n      info: this.info.toJSON(),\n    }\n    if (Array.isArray(this.fields) && this.fields.length) {\n      result.fields = [...this.fields]\n    }\n    if (Array.isArray(this.semantics) && this.semantics.length) {\n      result.semantics = toRaw(this, this.semantics)?.map((i) => structuredClone(i))\n    }\n    if (Array.isArray(this.tags) && this.tags.length) {\n      result.tags = [...(toRaw(this, this.tags) as string[])]\n    }\n    if (typeof this.deprecated === 'boolean') {\n      result.deprecated = this.deprecated\n    }\n    return result\n  }\n\n  /**\n   * Returns a parent data entity where this data property\n   * exist.\n   *\n   * @returns The parent `DomainModel` or undefined if not found.\n   * @example\n   * ```typescript\n   * const parent = entity.getParentInstance();\n   * if (parent) {\n   *   console.log(parent.key);\n   * }\n   * ```\n   */\n  getParentInstance(): DomainModel | undefined {\n    const parentKey = this.root.graph.parent(this.key)\n    if (!parentKey) {\n      return undefined\n    }\n    return this.root.graph.node(parentKey) as DomainModel | undefined\n  }\n\n  /**\n   * Adds a property to this entity.\n   *\n   * @param property The partial property schema.\n   * @returns The created `DomainProperty` instance.\n   * @example\n   * ```typescript\n   * const property = entity.addProperty({\n   *   key: 'name',\n   *   type: 'string',\n   *   required: true,\n   * })\n   * ```\n   */\n  addProperty(property?: Partial<DomainPropertySchema>): DomainProperty {\n    if (property && property.key && this.root.graph.hasNode(property.key)) {\n      throw new Error(`Trying to add a property ${property.key}, but it already exists`)\n    }\n    const instance = new DomainProperty(this.root, this.key, property)\n    this.root.graph.setNode(instance.key, instance)\n    this.root.graph.setEdge(this.key, instance.key, { type: 'property' })\n    this.fields.push({\n      type: 'property',\n      key: instance.key,\n    })\n    this.root.notifyChange()\n    return instance\n  }\n\n  /**\n   * Removes a property from this entity.\n   *\n   * @param key The key of the property to remove.\n   * @throws {RemovePropertyException} When the property does not exist.\n   * @example\n   * ```typescript\n   * entity.removeProperty('name')\n   * ```\n   */\n  removeProperty(key: string): void {\n    if (!this.root.graph.hasNode(key)) {\n      throw new RemovePropertyException(`Trying to remove the ${key} property, but it doesn't exist`)\n    }\n    const prop = this.root.graph.node(key) as DomainProperty\n    if (prop.getParentInstance() !== this) {\n      throw new RemovePropertyException(`Trying to remove the ${key} property, but it doesn't belong to this entity`)\n    }\n    removeGraphNode(this.root.graph, key)\n    this.removeField(key)\n    this.root.notifyChange()\n  }\n\n  /**\n   * A shortcut to `listProperties()`.\n   */\n  get properties(): Generator<DomainProperty> {\n    return this.listProperties()\n  }\n\n  /**\n   * Lists all properties of this entity.\n   *\n   * Note, it accounts for the order of the properties as\n   * defined in the `fields` array.\n   *\n   * @returns A generator that yields each `DomainProperty`.\n   * @example\n   * ```typescript\n   * for (const property of entity.listProperties()) {\n   *   console.log(property.key);\n   * }\n   * ```\n   */\n  *listProperties(): Generator<DomainProperty> {\n    for (const { key, type } of this.fields) {\n      if (type !== 'property') {\n        continue\n      }\n      const node = this.root.graph.node(key)\n      if (!node || node.kind !== DomainPropertyKind) {\n        continue\n      }\n      yield node\n    }\n  }\n\n  /**\n   * Checks if this entity has any properties.\n   *\n   * @returns True if the entity has properties.\n   * @example\n   * ```typescript\n   * if (entity.hasProperties()) {\n   *   // ...\n   * }\n   * ```\n   */\n  hasProperties(): boolean {\n    return this.fields.some((item) => item.type === 'property')\n  }\n\n  /**\n   * A shortcut to `listParents()`.\n   */\n  get parents(): Generator<DomainEntity> {\n    return this.listParents()\n  }\n\n  /**\n   * Lists all parent entities of this entity.\n   *\n   * @returns A generator that yields each parent `DomainEntity`.\n   * @example\n   * ```typescript\n   * for (const parent of entity.listParents()) {\n   *   console.log(parent.key);\n   * }\n   * ```\n   */\n  *listParents(): Generator<DomainEntity> {\n    for (const edge of this.root.graph.outEdges(this.key)) {\n      const value = this.root.graph.edge(edge)\n      if (!value || value.type !== 'parent') {\n        continue\n      }\n      const parent = this.root.graph.node(edge.w) as DomainEntity\n      if (parent) {\n        yield parent\n      }\n    }\n  }\n\n  /**\n   * Adds a parent to this entity.\n   *\n   * @param key The key of the parent entity.\n   * @param domain The key of the foreign domain the parent belongs to.\n   * @returns `this` for chaining.\n   * @throws ValidationError When the parent does not exist or a circular dependency is detected.\n   * @example\n   * ```typescript\n   * entity.addParent('baseEntity');\n   * ```\n   */\n  addParent(key: string, domain?: string): this {\n    const effectiveKey = this.domain.buildReferenceKey(key, domain)\n    // Prevent adding self as parent\n    if (effectiveKey === this.key) {\n      const message = 'Entity cannot be a parent of itself'\n      throw new ValidationError(\n        [\n          {\n            field: 'parents',\n            message,\n            rule: 'circular',\n          },\n        ],\n        { message }\n      )\n    }\n    const { graph } = this.root\n    if (!graph.hasNode(effectiveKey)) {\n      let message = `Entity with key \"${key}\" not found`\n      if (domain) {\n        message += ` in domain \"${domain}\"`\n      }\n      throw new ValidationError(\n        [\n          {\n            field: 'parents',\n            message,\n            rule: 'required',\n          },\n        ],\n        { message }\n      )\n    }\n    // Check for circular inheritance\n    if (this.hasCircularParent(effectiveKey)) {\n      const message = `Circular inheritance detected. Cannot add ${key} as a parent`\n      throw new ValidationError(\n        [\n          {\n            field: 'parents',\n            message,\n            rule: 'circular',\n          },\n        ],\n        { message }\n      )\n    }\n    if (graph.outEdges(this.key, effectiveKey).next().value) {\n      const message = `Parent ${key} already exists`\n      throw new ValidationError(\n        [\n          {\n            field: 'parents',\n            message,\n            rule: 'unique',\n          },\n        ],\n        { message }\n      )\n    }\n    // Parents are associated through graph edges.\n    // Otherwise it would collide with the parent model.\n    if (domain) {\n      graph.setEdge(this.key, effectiveKey, { type: 'parent', domain, foreign: true })\n    } else {\n      graph.setEdge(this.key, effectiveKey, { type: 'parent' })\n    }\n    this.root.notifyChange()\n    return this\n  }\n\n  /**\n   * Removes a parent from this entity.\n   *\n   * @param key The key of the parent entity to remove.\n   * @param domain Optional domain key if the parent belongs to a foreign domain.\n   * @returns `this` for chaining.\n   * @throws Error When the parent does not exist.\n   * @example\n   * ```typescript\n   * // Remove local parent\n   * entity.removeParent('baseEntity');\n   *\n   * // Remove foreign domain parent\n   * entity.removeParent('baseEntity', 'externalDomain');\n   * ```\n   */\n  removeParent(key: string, domain?: string): this {\n    const { graph } = this.root\n    const effectiveKey = this.domain.buildReferenceKey(key, domain)\n\n    if (!graph.hasEdge(this.key, effectiveKey)) {\n      let message = `Trying to remove a parent ${key} from ${this.key}, but it doesn't exist`\n      if (domain) {\n        message = `Trying to remove a foreign parent ${key} from domain \"${domain}\" from ${this.key}, but it doesn't exist`\n      }\n      throw new Error(message)\n    }\n\n    // Verify it's actually a parent edge\n    const edge = graph.edge(this.key, effectiveKey)\n    if (!edge || edge.type !== 'parent') {\n      let message = `Edge between ${this.key} and ${key} exists but is not a parent relationship`\n      if (domain) {\n        message = `Edge between ${this.key} and ${key} in domain \"${domain}\" exists but is not a parent relationship`\n      }\n      throw new Error(message)\n    }\n\n    graph.removeEdge(this.key, effectiveKey)\n    this.root.notifyChange()\n    return this\n  }\n\n  /**\n   * Checks if this entity has any parents.\n   *\n   * @returns True if the entity has parents.\n   * @example\n   * ```typescript\n   * if (entity.hasParents()) {\n   *   // ...\n   * }\n   * ```\n   */\n  hasParents(): boolean {\n    for (const edge of this.root.graph.outEdges(this.key)) {\n      if (this.root.graph.edge(edge)?.type === 'parent') {\n        return true\n      }\n    }\n    return false\n  }\n\n  /**\n   * Checks if the passed entity has a circular parent\n   * relationship when attempting to add a new parent.\n   *\n   * @param key The key of the parent being added.\n   * @returns True if adding this parent would create a\n   *   circular relationship.\n   */\n  hasCircularParent(key: string): boolean {\n    const { graph } = this.root\n\n    // Check if new parent is one of the children.\n    for (const edge of graph.outEdges(key, this.key)) {\n      if (graph.edge(edge)?.type === 'parent') {\n        return true\n      }\n    }\n\n    // check if this entity is in parents chain.\n    let current: DomainEntity | undefined = graph.node(key) as DomainEntity | undefined\n    while (current) {\n      if (current.key === this.key) {\n        return true\n      }\n      const parents = [...current.listParents()]\n      if (parents.length === 0) {\n        break\n      }\n      // Assuming single inheritance\n      // TODO: Update this to check for multiple parents.\n      current = parents[0]\n    }\n\n    return false\n  }\n\n  /**\n   * Creates breadcrumbs from this entity to the root\n   * namespace.\n   *\n   * @returns An array of `FileBreadcrumb` instances.\n   * @example\n   * ```typescript\n   * const breadcrumbs = entity.breadcrumbs();\n   * console.log(breadcrumbs);\n   * ```\n   */\n  breadcrumbs(): FileBreadcrumb[] {\n    const result: FileBreadcrumb[] = []\n    result.push({\n      key: this.key,\n      name: this.info.getLabel('Unnamed entity'),\n      kind: DomainEntityKind,\n    })\n    const model = this.getParentInstance()\n    if (model) {\n      result.push({\n        key: model.key,\n        kind: model.kind,\n        name: model.info.getLabel('Unnamed model'),\n      })\n      let parent: DataDomain | DomainNamespace = model.getParentInstance()\n      while (parent && parent !== this.root) {\n        result.push({\n          key: parent.key,\n          kind: parent.kind,\n          name: parent.info.getLabel('Unnamed namespace'),\n        })\n        const typed = parent as DomainNamespace\n        parent = typed.getParentInstance()\n      }\n    }\n    result.push({\n      key: this.root.key,\n      name: this.root.info.getLabel('Unnamed data domain'),\n      kind: this.root.kind,\n    })\n    return result.reverse()\n  }\n\n  /**\n   * Adds an association to this entity.\n   *\n   * Add rules:\n   * - If the target is specified, it has to exist in the graph.\n   * - The association targets can be local or foreign.\n   *\n   * Please note that you can't just add targets to the association schema.\n   * This function manipulates the graph to insert the required metadata.\n   *\n   * @param input The partial association schema.\n   * @returns The created `DomainAssociation` instance.\n   * @throws Error When the target entity does not exist.\n   * @example\n   * ```typescript\n   * const association = entity.addAssociation({ info: { name: 'Address' }, targets: [{ key: 'address' }] });\n   * ```\n   */\n  addAssociation(input: Partial<DomainAssociationSchema> = {}): DomainAssociation {\n    const { graph } = this.root\n\n    // clean up any target information from the input\n    // so we won't break the graph and the app.\n    const inputCopy = { ...input }\n    const targets = inputCopy.targets\n    delete inputCopy.targets\n\n    const hasTargets = Array.isArray(targets) && targets.length\n    if (hasTargets) {\n      for (const target of targets) {\n        if (target.domain && target.key) {\n          // target is foreign\n          const foreignKey = `${target.domain}:${target.key}`\n          if (!graph.hasNode(foreignKey)) {\n            throw new Error(`Foreign entity ${foreignKey} not found`)\n          }\n        } else if (target.key) {\n          if (!graph.hasNode(target.key)) {\n            throw new Error(`Target entity ${target.key} not found`)\n          }\n        }\n      }\n    }\n\n    const item = new DomainAssociation(this.root, this.key, inputCopy)\n    graph.setNode(item.key, item)\n    graph.setEdge(this.key, item.key, { type: 'association' })\n    if (hasTargets) {\n      for (const target of targets) {\n        item.addTarget(target.key, target.domain)\n      }\n    }\n    this.fields.push({ type: 'association', key: item.key })\n    this.root.notifyChange()\n    return item\n  }\n\n  /**\n   * Removes an association from this entity.\n   *\n   * @param key The key of the association to remove.\n   * @throws Error When the association does not exist.\n   * @example\n   * ```typescript\n   * entity.removeAssociation('address');\n   * ```\n   */\n  removeAssociation(key: string): void {\n    if (!this.root.graph.hasEdge(this.key, key)) {\n      throw new Error(`Unable to find a connection between this entity and the ${key} association`)\n    }\n    const edge = this.root.graph.edge(this.key, key)\n    if (!edge || edge.type !== 'association') {\n      throw new Error(`Association ${key} does not exist`)\n    }\n    removeGraphNode(this.root.graph, key)\n    this.removeField(key)\n    this.root.notifyChange()\n  }\n\n  /**\n   * A shortcut to `listAssociations()`.\n   */\n  get associations(): Generator<DomainAssociation> {\n    return this.listAssociations()\n  }\n\n  /**\n   * Lists all associations of this entity.\n   *\n   * The order of the associations is defined in the `fields` array.\n   *\n   * @returns A generator that yields each\n   *   `DomainAssociation`.\n   * @example\n   * ```typescript\n   * for (const association of entity.listAssociations()) {\n   *   console.log(association.key);\n   * }\n   * ```\n   */\n  *listAssociations(): Generator<DomainAssociation> {\n    for (const { key, type } of this.fields) {\n      if (type !== 'association') {\n        continue\n      }\n      const node = this.root.graph.node(key)\n      if (!node || node.kind !== DomainAssociationKind) {\n        continue\n      }\n      yield node\n    }\n  }\n\n  /**\n   * Checks if this entity has any associations.\n   *\n   * @returns True if the entity has associations.\n   * @example\n   * ```typescript\n   * if (entity.hasAssociations()) {\n   *   // ...\n   * }\n   * ```\n   */\n  hasAssociations(): boolean {\n    return this.fields.some((item) => item.type === 'association')\n  }\n\n  /**\n   * Lists all fields (properties and associations) of this entity.\n   *\n   * @returns A generator that yields each `DomainAssociation` or `DomainProperty`.\n   * @example\n   * ```typescript\n   * for (const field of entity.listFields()) {\n   *   console.log(field.key);\n   * }\n   * ```\n   */\n  *listFields(): Generator<DomainAssociation | DomainProperty> {\n    for (const { key } of this.fields) {\n      const node = this.root.graph.node(key)\n      if (!node) {\n        continue\n      }\n      if (node.kind === DomainAssociationKind || node.kind === DomainPropertyKind) {\n        yield node\n      }\n    }\n  }\n\n  /**\n   * Checks if this entity has any fields (properties or associations).\n   *\n   * @returns True if the entity has fields.\n   * @example\n   * ```typescript\n   * if (entity.hasFields()) {\n   *   // ...\n   * }\n   * ```\n   */\n  hasFields(): boolean {\n    return this.fields.length > 0\n  }\n\n  private removeField(key: string): void {\n    this.fields = this.fields.filter((item) => item.key !== key)\n  }\n\n  /**\n   * Creates an AMF's data Shape.\n   *\n   * The property itself is auto-generated. If the `schema` is defined then it is used\n   * as the `range` of the property. Otherwise basic shape is generated for the range.\n   *\n   * This is a preferred way of reading the AMF shape as this synchronizes changed\n   * data properties with the shape definition.\n   *\n   * @returns AMF property shape definition.\n   */\n  toApiShape(): Shapes.IShapeUnion {\n    const serializer = new ShapeGenerator()\n    return serializer.entity(this)\n  }\n\n  /**\n   * Reads the schema of the Entity and generates an example for it.\n   *\n   * @param mime The mime type of the example.\n   * @param opts The example generation options.\n   * @returns The generated example.\n   * @example\n   * ```typescript\n   * const example = entity.toExample('application/json');\n   * console.log(example);\n   * ```\n   */\n  toExample(mime: string, opts: IShapeRenderOptions = {}): string | number | boolean | null | undefined {\n    const shape = this.toApiShape()\n    const generator = new ApiSchemaGenerator(mime, {\n      renderExamples: opts.renderExamples ?? true,\n      renderMocked: opts.renderMocked ?? true,\n      renderOptional: opts.renderOptional ?? true,\n      selectedUnions: opts.selectedUnions,\n    })\n    return generator.generate(shape)\n  }\n\n  /**\n   * Checks whether the entity is a child of the given namespace or data model.\n   * The relationship doesn't have to be direct, as long as the entity\n   * is in the hierarchy it will return true.\n   *\n   * @param key The key of the parent to check.\n   * @returns True if this entity is a child of the given namespace or data model.\n   */\n  isChildOf(key: string): boolean {\n    if (this.key === key) {\n      return false\n    }\n    const parent = this.getParentInstance()\n    if (!parent) {\n      return false\n    }\n    if (parent.key === key) {\n      return true\n    }\n    return parent.isChildOf(key)\n  }\n\n  /**\n   * Finds the primary key property of this entity.\n   * @returns The primary key property of this entity or undefined if not found.\n   */\n  primaryKey(): DomainProperty | undefined {\n    for (const property of this.properties) {\n      if (property.primary) {\n        return property\n      }\n    }\n    let property: DomainProperty | undefined\n    for (const parent of this.listParents()) {\n      const prop = parent.primaryKey()\n      if (prop) {\n        // According to the validation rules, the last parent\n        // that has the property will be used as the source of\n        // the property.\n        // In the future, we may add a schema definition to the entity that\n        // will explicitly define which property to use.\n        property = prop\n      }\n    }\n    return property\n  }\n\n  /**\n   * Adds or updates a semantic to the entity.\n   * @param semantic The semantic to add to the entity.\n   * @throws Error if the semantic is not an entity semantic.\n   */\n  addSemantic(semantic: AppliedDataSemantic): void {\n    const sem = DataSemantics[semantic.id]\n    if (!isEntitySemantic(sem)) {\n      throw new Error(`Invalid semantic type: ${semantic.id}. Expected an entity semantic.`)\n    }\n    const index = this.semantics.findIndex((s) => s.id === semantic.id)\n    if (index >= 0) {\n      this.semantics[index] = semantic\n    } else {\n      this.semantics.push(semantic)\n    }\n    this.domain.notifyChange()\n  }\n\n  /**\n   * Removes a semantic from the entity.\n   * @param semanticId The ID of the semantic to remove.\n   */\n  removeSemantic(semanticId: SemanticType): void {\n    const index = this.semantics.findIndex((s) => s.id === semanticId)\n    if (index >= 0) {\n      this.semantics.splice(index, 1)\n      this.domain.notifyChange()\n    }\n  }\n\n  /**\n   * Checks if the entity has a specific semantic.\n   * @param semanticId The ID of the semantic to check.\n   * @returns True if the semantic is present, false otherwise.\n   */\n  hasSemantic(semanticId: SemanticType): boolean {\n    return this.semantics.some((s) => s.id === semanticId)\n  }\n\n  /**\n   * Generates a unique name by appending a number to the base name.\n   * @param baseName The base name to make unique.\n   * @returns A unique name within the current entity.\n   */\n  generateUniqueName(baseName: string): string {\n    const existingNames = new Set<string>()\n    for (const field of this.listFields()) {\n      if (field.info.name) {\n        existingNames.add(field.info.name)\n      }\n    }\n\n    let counter = 2\n    let newName = `${baseName}_copy`\n    while (existingNames.has(newName)) {\n      newName = `${baseName}_copy_${counter}`\n      counter++\n    }\n\n    return newName\n  }\n}\n"]}
+{"version":3,"file":"DomainEntity.js","sourceRoot":"","sources":["../../../src/modeling/DomainEntity.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,EAAE,aAAa,EAA4B,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAoB,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;AAE3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,cAAc,EAA6B,MAAM,qBAAqB,CAAA;AAC/E,OAAO,EAAE,uBAAuB,EAAE,MAAM,4CAA4C,CAAA;AACpF,OAAO,EAAE,iBAAiB,EAA2B,MAAM,wBAAwB,CAAA;AAInF,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAA+C,MAAM,gBAAgB,CAAA;AA+C7G;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0DG;IACU,YAAY;sBAAS,aAAa;;;;;;;;;;;;;iBAAlC,YAAa,SAAQ,WAAa;;;gCAS5C,cAAc,EAAE;gCAKhB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;qCAKxB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;sCAaxB,QAAQ,EAAE;YAvBO,iKAAS,IAAI,6BAAJ,IAAI,mFAAO;YAKZ,iKAAS,IAAI,6BAAJ,IAAI,mFAAU;YAKvB,gLAAS,SAAS,6BAAT,SAAS,6FAA4B;YAa5D,mLAAS,UAAU,6BAAV,UAAU,+FAAqB;;;QA/BpD;;WAEG;QACM,IAAI,CAAyB;QAKpB,6EAAoB;QAHtC;;WAEG;QACe,IAAS,IAAI,0CAAO;QAApB,IAAS,IAAI,gDAAO;QAKZ,iIAAuB;QAHjD;;WAEG;QACuB,IAAS,IAAI,0CAAU;QAAvB,IAAS,IAAI,gDAAU;QAKvB,kIAA4C,EAAE;QAExE;;;;;WAKG;WAPqE;QAHxE;;WAEG;QACuB,IAAS,SAAS,+CAA4B;QAA9C,IAAS,SAAS,qDAA4B;QAQxE,iFAAoC;QANpC;;;;;WAKG;QACH,IAAS,MAAM,4CAAqB;QAApC,IAAS,MAAM,kDAAqB;QAKxB,yFAAwC;QAHpD;;WAEG;QACS,IAAS,UAAU,gDAAqB;QAAxC,IAAS,UAAU,sDAAqB;QAEpD;;;;;WAKG;QACH,MAAM,CAAC,YAAY,CAAC,QAAqC,EAAE;YACzD,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,KAAK,CAAA;YACrE,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;YACxE,MAAM,MAAM,GAAuB;gBACjC,IAAI,EAAE,gBAAgB;gBACtB,GAAG;gBACH,IAAI;aACL,CAAA;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAA;YACzB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,MAAM,CAAC,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;YACnC,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC1B,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAA;YAC7B,CAAC;YACD,IAAI,OAAO,UAAU,KAAK,SAAS,EAAE,CAAC;gBACpC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAA;YAChC,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED;;;;;;;;WAQG;QACH,YAAY,IAAgB,EAAE,KAAmC;YAC/D,MAAM,IAAI,GAAG,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;YAC7C,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;;YACrB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;YAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAA;YAC5B,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,IAAI,GAAG,EAAE,CAAA;YAChB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAA;YACtE,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,SAAS,GAAG,EAAE,CAAA;YACrB,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;YAChC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,MAAM,GAAG,EAAE,CAAA;YAClB,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;YACnC,CAAC;SACF;QAED;;;;WAIG;QACH,MAAM;YACJ,MAAM,MAAM,GAAuB;gBACjC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;aACzB,CAAA;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACrD,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAA;YAClC,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;gBAC3D,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAA;YAChF,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjD,MAAM,CAAC,IAAI,GAAG,CAAC,GAAI,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAc,CAAC,CAAA;YACzD,CAAC;YACD,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;gBACzC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;YACrC,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED;;;;;;;;;;;;WAYG;QACH,iBAAiB;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAClD,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAA4B,CAAA;QACnE,CAAC;QAED;;;;;;;;;;;;;WAaG;QACH,WAAW,CAAC,QAAwC;YAClD,IAAI,QAAQ,IAAI,QAAQ,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,GAAG,yBAAyB,CAAC,CAAA;YACpF,CAAC;YACD,MAAM,QAAQ,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAClE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAA;YAC/C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAA;YACrE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;gBACf,IAAI,EAAE,UAAU;gBAChB,GAAG,EAAE,QAAQ,CAAC,GAAG;aAClB,CAAC,CAAA;YACF,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;YACxB,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED;;;;;;;;;WASG;QACH,cAAc,CAAC,GAAW;YACxB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,MAAM,IAAI,uBAAuB,CAAC,wBAAwB,GAAG,iCAAiC,CAAC,CAAA;YACjG,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAmB,CAAA;YACxD,IAAI,IAAI,CAAC,iBAAiB,EAAE,KAAK,IAAI,EAAE,CAAC;gBACtC,MAAM,IAAI,uBAAuB,CAAC,wBAAwB,GAAG,iDAAiD,CAAC,CAAA;YACjH,CAAC;YACD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;YACrB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;QAC1B,CAAC;QAED;;WAEG;QACH,IAAI,UAAU;YACZ,OAAO,IAAI,CAAC,cAAc,EAAE,CAAA;QAC9B,CAAC;QAED;;;;;;;;;;;;;WAaG;QACH,CAAC,cAAc;YACb,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACxC,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;oBACxB,SAAQ;gBACV,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;oBAC9C,SAAQ;gBACV,CAAC;gBACD,MAAM,IAAI,CAAA;YACZ,CAAC;QACH,CAAC;QAED;;;;;;;;;;WAUG;QACH,aAAa;YACX,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAA;QAC7D,CAAC;QAED;;WAEG;QACH,IAAI,OAAO;YACT,OAAO,IAAI,CAAC,WAAW,EAAE,CAAA;QAC3B,CAAC;QAED;;;;;;;;;;WAUG;QACH,CAAC,WAAW;YACV,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACxC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACtC,SAAQ;gBACV,CAAC;gBACD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAiB,CAAA;gBAC3D,IAAI,MAAM,EAAE,CAAC;oBACX,MAAM,MAAM,CAAA;gBACd,CAAC;YACH,CAAC;QACH,CAAC;QAED;;;;;;WAMG;QACH,cAAc,CAAC,YAA2B,IAAI;YAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAA;YACjC,MAAM,OAAO,GAAmB,EAAE,CAAA;YAClC,MAAM,KAAK,GAAmB,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAA;YAErD,IAAI,KAAK,GAAG,CAAC,CAAA;YACb,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAA;gBAC7B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC7B,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;oBACvB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;oBACpB,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;gBACrC,CAAC;YACH,CAAC;YAED,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;gBACzB,OAAO,CAAC,OAAO,EAAE,CAAA;YACnB,CAAC;YAED,OAAO,OAAO,CAAA;QAChB,CAAC;QAED;;;;;;;;;;;WAWG;QACH,SAAS,CAAC,GAAW,EAAE,MAAe;YACpC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YAC/D,gCAAgC;YAChC,IAAI,YAAY,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,qCAAqC,CAAA;gBACrD,MAAM,IAAI,eAAe,CACvB;oBACE;wBACE,KAAK,EAAE,SAAS;wBAChB,OAAO;wBACP,IAAI,EAAE,UAAU;qBACjB;iBACF,EACD,EAAE,OAAO,EAAE,CACZ,CAAA;YACH,CAAC;YACD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAA;YAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;gBACjC,IAAI,OAAO,GAAG,oBAAoB,GAAG,aAAa,CAAA;gBAClD,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,IAAI,eAAe,MAAM,GAAG,CAAA;gBACrC,CAAC;gBACD,MAAM,IAAI,eAAe,CACvB;oBACE;wBACE,KAAK,EAAE,SAAS;wBAChB,OAAO;wBACP,IAAI,EAAE,UAAU;qBACjB;iBACF,EACD,EAAE,OAAO,EAAE,CACZ,CAAA;YACH,CAAC;YACD,iCAAiC;YACjC,IAAI,IAAI,CAAC,iBAAiB,CAAC,YAAY,CAAC,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,6CAA6C,GAAG,cAAc,CAAA;gBAC9E,MAAM,IAAI,eAAe,CACvB;oBACE;wBACE,KAAK,EAAE,SAAS;wBAChB,OAAO;wBACP,IAAI,EAAE,UAAU;qBACjB;iBACF,EACD,EAAE,OAAO,EAAE,CACZ,CAAA;YACH,CAAC;YACD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;gBACxD,MAAM,OAAO,GAAG,UAAU,GAAG,iBAAiB,CAAA;gBAC9C,MAAM,IAAI,eAAe,CACvB;oBACE;wBACE,KAAK,EAAE,SAAS;wBAChB,OAAO;wBACP,IAAI,EAAE,QAAQ;qBACf;iBACF,EACD,EAAE,OAAO,EAAE,CACZ,CAAA;YACH,CAAC;YACD,8CAA8C;YAC9C,oDAAoD;YACpD,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;YAClF,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAA;YAC3D,CAAC;YACD,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;YACxB,OAAO,IAAI,CAAA;QACb,CAAC;QAED;;;;;;;;;;;;;;;WAeG;QACH,YAAY,CAAC,GAAW,EAAE,MAAe;YACvC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAA;YAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YAE/D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,CAAC;gBAC3C,IAAI,OAAO,GAAG,6BAA6B,GAAG,SAAS,IAAI,CAAC,GAAG,wBAAwB,CAAA;gBACvF,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,GAAG,qCAAqC,GAAG,iBAAiB,MAAM,UAAU,IAAI,CAAC,GAAG,wBAAwB,CAAA;gBACrH,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;YAC1B,CAAC;YAED,qCAAqC;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;YAC/C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpC,IAAI,OAAO,GAAG,gBAAgB,IAAI,CAAC,GAAG,QAAQ,GAAG,0CAA0C,CAAA;gBAC3F,IAAI,MAAM,EAAE,CAAC;oBACX,OAAO,GAAG,gBAAgB,IAAI,CAAC,GAAG,QAAQ,GAAG,eAAe,MAAM,2CAA2C,CAAA;gBAC/G,CAAC;gBACD,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;YAC1B,CAAC;YAED,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,CAAA;YACxC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;YACxB,OAAO,IAAI,CAAA;QACb,CAAC;QAED;;;;;;;;;;WAUG;QACH,UAAU;YACR,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtD,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAClD,OAAO,IAAI,CAAA;gBACb,CAAC;YACH,CAAC;YACD,OAAO,KAAK,CAAA;QACd,CAAC;QAED;;;;;;;WAOG;QACH,iBAAiB,CAAC,GAAW;YAC3B,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAA;YAE3B,8CAA8C;YAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACxC,OAAO,IAAI,CAAA;gBACb,CAAC;YACH,CAAC;YAED,4CAA4C;YAC5C,IAAI,OAAO,GAA6B,KAAK,CAAC,IAAI,CAAC,GAAG,CAA6B,CAAA;YACnF,OAAO,OAAO,EAAE,CAAC;gBACf,IAAI,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC;oBAC7B,OAAO,IAAI,CAAA;gBACb,CAAC;gBACD,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAA;gBAC1C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,MAAK;gBACP,CAAC;gBACD,8BAA8B;gBAC9B,mDAAmD;gBACnD,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;YACtB,CAAC;YAED,OAAO,KAAK,CAAA;QACd,CAAC;QAED;;;;;;;;;;WAUG;QACH,WAAW;YACT,MAAM,MAAM,GAAqB,EAAE,CAAA;YACnC,MAAM,CAAC,IAAI,CAAC;gBACV,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC;gBAC1C,IAAI,EAAE,gBAAgB;aACvB,CAAC,CAAA;YACF,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACtC,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,CAAC;oBACV,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC;iBAC3C,CAAC,CAAA;gBACF,IAAI,MAAM,GAAiC,KAAK,CAAC,iBAAiB,EAAE,CAAA;gBACpE,OAAO,MAAM,IAAI,MAAM,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;oBACtC,MAAM,CAAC,IAAI,CAAC;wBACV,GAAG,EAAE,MAAM,CAAC,GAAG;wBACf,IAAI,EAAE,MAAM,CAAC,IAAI;wBACjB,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC;qBAChD,CAAC,CAAA;oBACF,MAAM,KAAK,GAAG,MAAyB,CAAA;oBACvC,MAAM,GAAG,KAAK,CAAC,iBAAiB,EAAE,CAAA;gBACpC,CAAC;YACH,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG;gBAClB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,qBAAqB,CAAC;gBACpD,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI;aACrB,CAAC,CAAA;YACF,OAAO,MAAM,CAAC,OAAO,EAAE,CAAA;QACzB,CAAC;QAED;;;;;;;;;;;;;;;;;WAiBG;QACH,cAAc,CAAC,QAA0C,EAAE;YACzD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,IAAI,CAAA;YAE3B,iDAAiD;YACjD,2CAA2C;YAC3C,MAAM,SAAS,GAAG,EAAE,GAAG,KAAK,EAAE,CAAA;YAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;YACjC,OAAO,SAAS,CAAC,OAAO,CAAA;YAExB,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,CAAA;YAC3D,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;wBAChC,oBAAoB;wBACpB,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,GAAG,EAAE,CAAA;wBACnD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;4BAC/B,MAAM,IAAI,KAAK,CAAC,kBAAkB,UAAU,YAAY,CAAC,CAAA;wBAC3D,CAAC;oBACH,CAAC;yBAAM,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;wBACtB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;4BAC/B,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,CAAC,GAAG,YAAY,CAAC,CAAA;wBAC1D,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAA;YAClE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA;YAC7B,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAA;YAC1D,IAAI,UAAU,EAAE,CAAC;gBACf,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC7B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;gBAC3C,CAAC;YACH,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAA;YACxD,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;YACxB,OAAO,IAAI,CAAA;QACb,CAAC;QAED;;;;;;;;;WASG;QACH,iBAAiB,CAAC,GAAW;YAC3B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC5C,MAAM,IAAI,KAAK,CAAC,2DAA2D,GAAG,cAAc,CAAC,CAAA;YAC/F,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;YAChD,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,iBAAiB,CAAC,CAAA;YACtD,CAAC;YACD,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YACrC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;YACrB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAA;QAC1B,CAAC;QAED;;WAEG;QACH,IAAI,YAAY;YACd,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAA;QAChC,CAAC;QAED;;;;;;;;;;;;;WAaG;QACH,CAAC,gBAAgB;YACf,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACxC,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;oBAC3B,SAAQ;gBACV,CAAC;gBACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACtC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,EAAE,CAAC;oBACjD,SAAQ;gBACV,CAAC;gBACD,MAAM,IAAI,CAAA;YACZ,CAAC;QACH,CAAC;QAED;;;;;;;;;;WAUG;QACH,eAAe;YACb,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,aAAa,CAAC,CAAA;QAChE,CAAC;QAED;;;;;;;;;;WAUG;QACH,CAAC,UAAU;YACT,KAAK,MAAM,EAAE,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;gBACtC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,SAAQ;gBACV,CAAC;gBACD,IAAI,IAAI,CAAC,IAAI,KAAK,qBAAqB,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;oBAC5E,MAAM,IAAI,CAAA;gBACZ,CAAC;YACH,CAAC;QACH,CAAC;QAED;;;;;;;;;;WAUG;QACH,SAAS;YACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAA;QAC/B,CAAC;QAEO,WAAW,CAAC,GAAW;YAC7B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC,CAAA;QAC9D,CAAC;QAED;;;;;;;;;;WAUG;QACH,UAAU;YACR,MAAM,UAAU,GAAG,IAAI,cAAc,EAAE,CAAA;YACvC,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QAChC,CAAC;QAED;;;;;;;;;;;WAWG;QACH,SAAS,CAAC,IAAY,EAAE,OAA4B,EAAE;YACpD,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAA;YAC/B,MAAM,SAAS,GAAG,IAAI,kBAAkB,CAAC,IAAI,EAAE;gBAC7C,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;gBAC3C,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI;gBACvC,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;gBAC3C,cAAc,EAAE,IAAI,CAAC,cAAc;aACpC,CAAC,CAAA;YACF,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;QAClC,CAAC;QAED;;;;;;;WAOG;QACH,SAAS,CAAC,GAAW;YACnB,IAAI,IAAI,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;gBACrB,OAAO,KAAK,CAAA;YACd,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAA;YACvC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,KAAK,CAAA;YACd,CAAC;YACD,IAAI,MAAM,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAA;YACb,CAAC;YACD,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAA;QAC9B,CAAC;QAED;;;WAGG;QACH,UAAU;YACR,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACvC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACrB,OAAO,QAAQ,CAAA;gBACjB,CAAC;YACH,CAAC;YACD,IAAI,QAAoC,CAAA;YACxC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,EAAE,CAAA;gBAChC,IAAI,IAAI,EAAE,CAAC;oBACT,qDAAqD;oBACrD,sDAAsD;oBACtD,gBAAgB;oBAChB,mEAAmE;oBACnE,gDAAgD;oBAChD,QAAQ,GAAG,IAAI,CAAA;gBACjB,CAAC;YACH,CAAC;YACD,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED;;;;WAIG;QACH,WAAW,CAAC,QAA6B;YACvC,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;YACtC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,0BAA0B,QAAQ,CAAC,EAAE,gCAAgC,CAAC,CAAA;YACxF,CAAC;YACD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAA;YACnE,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAA;YAClC,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;YAC/B,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAA;QAC5B,CAAC;QAED;;;WAGG;QACH,cAAc,CAAC,UAAwB;YACrC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAA;YAClE,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;gBACf,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;gBAC/B,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAA;YAC5B,CAAC;QACH,CAAC;QAED;;;;WAIG;QACH,WAAW,CAAC,UAAwB;YAClC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,UAAU,CAAC,CAAA;QACxD,CAAC;QAED;;;;WAIG;QACH,kBAAkB,CAAC,QAAgB;YACjC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAA;YACvC,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;gBACtC,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;oBACpB,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;gBACpC,CAAC;YACH,CAAC;YAED,IAAI,OAAO,GAAG,CAAC,CAAA;YACf,IAAI,OAAO,GAAG,GAAG,QAAQ,OAAO,CAAA;YAChC,OAAO,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,OAAO,GAAG,GAAG,QAAQ,SAAS,OAAO,EAAE,CAAA;gBACvC,OAAO,EAAE,CAAA;YACX,CAAC;YAED,OAAO,OAAO,CAAA;QAChB,CAAC;;;SAj1BU,YAAY","sourcesContent":["import type { DataDomain } from './DataDomain.js'\nimport { DomainAssociationKind, DomainEntityKind, DomainPropertyKind } from '../models/kinds.js'\nimport { DomainElement, type DomainElementSchema } from './DomainElement.js'\nimport { nanoid } from '../nanoid.js'\nimport { type ThingSchema, Thing } from '../models/Thing.js'\nimport { observed, retargetChange, toRaw } from '../decorators/observed.js'\nimport type { Shapes, IShapeRenderOptions } from '@api-client/amf-core'\nimport { ApiSchemaGenerator } from '@api-client/amf-core'\nimport { DomainProperty, type DomainPropertySchema } from './DomainProperty.js'\nimport { RemovePropertyException } from '../exceptions/remove_property_exception.js'\nimport { DomainAssociation, DomainAssociationSchema } from './DomainAssociation.js'\nimport type { FileBreadcrumb } from '../models/store/File.js'\nimport type { DomainModel } from './DomainModel.js'\nimport type { DomainNamespace } from './DomainNamespace.js'\nimport { ValidationError } from '../exceptions/validation_error.js'\nimport { ShapeGenerator } from './amf/ShapeGenerator.js'\nimport { removeGraphNode } from './GraphUtils.js'\nimport { DataSemantics, isEntitySemantic, type SemanticType, type AppliedDataSemantic } from './Semantics.js'\n\nexport interface EntityOrderedItem {\n  /**\n   * The type of the ordered item.\n   */\n  type: 'property' | 'association'\n\n  /**\n   * The key of the ordered item.\n   */\n  key: string\n}\n\nexport interface DomainEntitySchema extends DomainElementSchema {\n  kind: typeof DomainEntityKind\n  /**\n   * The domain entity description.\n   */\n  info: ThingSchema\n\n  /**\n   * Optional general purpose tags for the UI.\n   */\n  tags?: string[]\n\n  /**\n   * The semantics applied to this entity.\n   * This is a list of applied semantics that can be used to\n   * describe the entity in more detail.\n   */\n  semantics?: AppliedDataSemantic[]\n\n  /**\n   * The ordered list of fields (properties and associations) in the schema.\n   * These only keep references to the properties and associations.\n   * The order of the fields is important as it defines the order of the\n   * properties in the schema.\n   */\n  fields?: EntityOrderedItem[]\n\n  /**\n   * Whether this entity is deprecated.\n   */\n  deprecated?: boolean\n}\n\n/**\n * Represents an entity within a data domain model.\n *\n * A `DomainEntity` defines a structured data type,\n * containing properties and associations. It's a\n * fundamental building block for modeling complex data\n * structures.\n *\n * **Key Features:**\n *\n * - **Properties:** Defines the data elements (fields) within the entity.\n * - **Associations:** Defines relationships to other entities.\n * - **Inheritance:** Supports inheriting properties and associations from parent entities.\n * - **Metadata:** Supports tags, semantics, and deprecation status.\n * - **AMF Shape Generation:** Can be serialized to an AMF (API Modeling Framework) shape.\n * - **Example Generation:** Can generate example databased on its schema.\n *\n * **Usage:**\n *\n * The preferred way to create a `DomainEntity` is through\n * the `DomainModel.addEntity()` method.\n *\n * **Example:**\n *\n * ```typescript\n * const dataDomain = new DataDomain();\n * const userModel = dataDomain.addModel({ key: 'userModel' });\n * const userEntity = userModel.addEntity({ key: 'user' });\n * ```\n *\n * Entity Validation Rules:\n *\n * - **Primary Key:** An entity must have a primary key selected. This can come from a parent\n *   entity or be defined in the current entity.\n * - **Parent Entity:** The parent entity must exist in the graph.\n * - **Circular Dependency:** Adding a parent entity that creates a circular dependency is not allowed.\n * - **Unique Parent:** An entity cannot have the same parent more than once.\n * - **Property Shadowing:** A property can shadow a parent property. This means that if a property\n *   with the same key exists in both the parent and child entity, the child property will take precedence.\n * - **Association Shadowing:** An association can shadow a parent association. This means that if an\n *   association with the same key exists in both the parent and child entity,\n *   the child association will take precedence.\n * - **Property Resolution:** When the same property exists more than one parent and the child entity,\n *   doesn't explicitly define the property, then:\n *   - The last parent entity (iterating from the first entity to the last) that has the property\n *     will be used as the source of the property.\n * - **Association Resolution:** When the same association exists more than one parent and the child entity,\n *   doesn't explicitly define the association, then:\n *   - The last parent entity (iterating from the first entity to the last) that has the association\n *     will be used as the source of the association.\n * - **Minimum Required Properties:** An entity must have at least one property defined. Entities without properties\n *   are ignored in the system.\n * - **Entity Name**:\n *   - An entity must have a name defined.\n *   - The name has to follow the same rules as the names in a SQL database. This means that the name must be unique\n *     within the data domain and cannot contain special characters.\n * - **Association Targets:** An association must have a target entity defined.\n *   This means that the association must point to at least one entity.\n */\nexport class DomainEntity extends DomainElement {\n  /**\n   * The kind of the domain element.\n   */\n  override kind: typeof DomainEntityKind\n\n  /**\n   * The description of the domain entity.\n   */\n  @retargetChange() accessor info: Thing\n\n  /**\n   * Optional general purpose tags for the UI.\n   */\n  @observed({ deep: true }) accessor tags: string[]\n\n  /**\n   * Semantics applied to this property.\n   */\n  @observed({ deep: true }) accessor semantics: AppliedDataSemantic[] = []\n\n  /**\n   * The ordered list of fields (properties and associations) in the schema.\n   * These only keep references to the properties and associations.\n   * The order of the fields is important as it defines the order of the\n   * properties in the schema.\n   */\n  accessor fields: EntityOrderedItem[]\n\n  /**\n   * Whether this entity is deprecated.\n   */\n  @observed() accessor deprecated: boolean | undefined\n\n  /**\n   * Creates a full data entity schema with defaults.\n   *\n   * @param input The partial data entity schema.\n   * @returns The data entity schema.\n   */\n  static createSchema(input: Partial<DomainEntitySchema> = {}): DomainEntitySchema {\n    const { key = nanoid(), tags, semantics, fields, deprecated } = input\n    const info = Thing.fromJSON(input.info, { name: 'new_entity' }).toJSON()\n    const result: DomainEntitySchema = {\n      kind: DomainEntityKind,\n      key,\n      info,\n    }\n    if (Array.isArray(tags)) {\n      result.tags = [...tags]\n    }\n    if (Array.isArray(semantics)) {\n      result.semantics = [...semantics]\n    }\n    if (Array.isArray(fields)) {\n      result.fields = [...fields]\n    }\n    if (typeof deprecated === 'boolean') {\n      result.deprecated = deprecated\n    }\n    return result\n  }\n\n  /**\n   * Creates a new domain entity instance.\n   *\n   * You probably want to use the `DomainModel.addEntity()`\n   * method instead.\n   *\n   * @param root A reference to the root DataDomain instance.\n   * @param input The partial domain entity schema.\n   */\n  constructor(root: DataDomain, input?: Partial<DomainEntitySchema>) {\n    const init = DomainEntity.createSchema(input)\n    super(root, init.key)\n    this.kind = DomainEntityKind\n    this.info = new Thing(init.info)\n    if (Array.isArray(init.tags)) {\n      this.tags = [...init.tags]\n    } else {\n      this.tags = []\n    }\n    if (Array.isArray(init.semantics)) {\n      this.semantics = init.semantics.map((item) => structuredClone(item))\n    } else {\n      this.semantics = []\n    }\n    if (Array.isArray(init.fields)) {\n      this.fields = [...init.fields]\n    } else {\n      this.fields = []\n    }\n    if (typeof init.deprecated === 'boolean') {\n      this.deprecated = init.deprecated\n    }\n  }\n\n  /**\n   * Generates a JSON representation of the entity.\n   *\n   * @returns A plain object representation of the `DomainEntity`.\n   */\n  toJSON(): DomainEntitySchema {\n    const result: DomainEntitySchema = {\n      kind: this.kind,\n      key: this.key,\n      info: this.info.toJSON(),\n    }\n    if (Array.isArray(this.fields) && this.fields.length) {\n      result.fields = [...this.fields]\n    }\n    if (Array.isArray(this.semantics) && this.semantics.length) {\n      result.semantics = toRaw(this, this.semantics)?.map((i) => structuredClone(i))\n    }\n    if (Array.isArray(this.tags) && this.tags.length) {\n      result.tags = [...(toRaw(this, this.tags) as string[])]\n    }\n    if (typeof this.deprecated === 'boolean') {\n      result.deprecated = this.deprecated\n    }\n    return result\n  }\n\n  /**\n   * Returns a parent data entity where this data property\n   * exist.\n   *\n   * @returns The parent `DomainModel` or undefined if not found.\n   * @example\n   * ```typescript\n   * const parent = entity.getParentInstance();\n   * if (parent) {\n   *   console.log(parent.key);\n   * }\n   * ```\n   */\n  getParentInstance(): DomainModel | undefined {\n    const parentKey = this.root.graph.parent(this.key)\n    if (!parentKey) {\n      return undefined\n    }\n    return this.root.graph.node(parentKey) as DomainModel | undefined\n  }\n\n  /**\n   * Adds a property to this entity.\n   *\n   * @param property The partial property schema.\n   * @returns The created `DomainProperty` instance.\n   * @example\n   * ```typescript\n   * const property = entity.addProperty({\n   *   key: 'name',\n   *   type: 'string',\n   *   required: true,\n   * })\n   * ```\n   */\n  addProperty(property?: Partial<DomainPropertySchema>): DomainProperty {\n    if (property && property.key && this.root.graph.hasNode(property.key)) {\n      throw new Error(`Trying to add a property ${property.key}, but it already exists`)\n    }\n    const instance = new DomainProperty(this.root, this.key, property)\n    this.root.graph.setNode(instance.key, instance)\n    this.root.graph.setEdge(this.key, instance.key, { type: 'property' })\n    this.fields.push({\n      type: 'property',\n      key: instance.key,\n    })\n    this.root.notifyChange()\n    return instance\n  }\n\n  /**\n   * Removes a property from this entity.\n   *\n   * @param key The key of the property to remove.\n   * @throws {RemovePropertyException} When the property does not exist.\n   * @example\n   * ```typescript\n   * entity.removeProperty('name')\n   * ```\n   */\n  removeProperty(key: string): void {\n    if (!this.root.graph.hasNode(key)) {\n      throw new RemovePropertyException(`Trying to remove the ${key} property, but it doesn't exist`)\n    }\n    const prop = this.root.graph.node(key) as DomainProperty\n    if (prop.getParentInstance() !== this) {\n      throw new RemovePropertyException(`Trying to remove the ${key} property, but it doesn't belong to this entity`)\n    }\n    removeGraphNode(this.root.graph, key)\n    this.removeField(key)\n    this.root.notifyChange()\n  }\n\n  /**\n   * A shortcut to `listProperties()`.\n   */\n  get properties(): Generator<DomainProperty> {\n    return this.listProperties()\n  }\n\n  /**\n   * Lists all properties of this entity.\n   *\n   * Note, it accounts for the order of the properties as\n   * defined in the `fields` array.\n   *\n   * @returns A generator that yields each `DomainProperty`.\n   * @example\n   * ```typescript\n   * for (const property of entity.listProperties()) {\n   *   console.log(property.key);\n   * }\n   * ```\n   */\n  *listProperties(): Generator<DomainProperty> {\n    for (const { key, type } of this.fields) {\n      if (type !== 'property') {\n        continue\n      }\n      const node = this.root.graph.node(key)\n      if (!node || node.kind !== DomainPropertyKind) {\n        continue\n      }\n      yield node\n    }\n  }\n\n  /**\n   * Checks if this entity has any properties.\n   *\n   * @returns True if the entity has properties.\n   * @example\n   * ```typescript\n   * if (entity.hasProperties()) {\n   *   // ...\n   * }\n   * ```\n   */\n  hasProperties(): boolean {\n    return this.fields.some((item) => item.type === 'property')\n  }\n\n  /**\n   * A shortcut to `listParents()`.\n   */\n  get parents(): Generator<DomainEntity> {\n    return this.listParents()\n  }\n\n  /**\n   * Lists all parent entities of this entity (only the first level).\n   *\n   * @returns A generator that yields each parent `DomainEntity`.\n   * @example\n   * ```typescript\n   * for (const parent of entity.listParents()) {\n   *   console.log(parent.key);\n   * }\n   * ```\n   */\n  *listParents(): Generator<DomainEntity> {\n    for (const edge of this.root.graph.outEdges(this.key)) {\n      const value = this.root.graph.edge(edge)\n      if (!value || value.type !== 'parent') {\n        continue\n      }\n      const parent = this.root.graph.node(edge.w) as DomainEntity\n      if (parent) {\n        yield parent\n      }\n    }\n  }\n\n  /**\n   * Lists all parent entities recursively.\n   *\n   * @param direction The direction of the traversal. 'up' (default) lists from immediate parents up to the oldest.\n   *                  'down' lists from the oldest parents down to the immediate parents.\n   * @returns An array of parent `DomainEntity` instances, ordered according to the requested traversal direction.\n   */\n  listAllParents(direction: 'up' | 'down' = 'up'): DomainEntity[] {\n    const visited = new Set<string>()\n    const parents: DomainEntity[] = []\n    const queue: DomainEntity[] = [...this.listParents()]\n\n    let index = 0\n    while (index < queue.length) {\n      const parent = queue[index++]\n      if (!visited.has(parent.key)) {\n        visited.add(parent.key)\n        parents.push(parent)\n        queue.push(...parent.listParents())\n      }\n    }\n\n    if (direction === 'down') {\n      parents.reverse()\n    }\n\n    return parents\n  }\n\n  /**\n   * Adds a parent to this entity.\n   *\n   * @param key The key of the parent entity.\n   * @param domain The key of the foreign domain the parent belongs to.\n   * @returns `this` for chaining.\n   * @throws ValidationError When the parent does not exist or a circular dependency is detected.\n   * @example\n   * ```typescript\n   * entity.addParent('baseEntity');\n   * ```\n   */\n  addParent(key: string, domain?: string): this {\n    const effectiveKey = this.domain.buildReferenceKey(key, domain)\n    // Prevent adding self as parent\n    if (effectiveKey === this.key) {\n      const message = 'Entity cannot be a parent of itself'\n      throw new ValidationError(\n        [\n          {\n            field: 'parents',\n            message,\n            rule: 'circular',\n          },\n        ],\n        { message }\n      )\n    }\n    const { graph } = this.root\n    if (!graph.hasNode(effectiveKey)) {\n      let message = `Entity with key \"${key}\" not found`\n      if (domain) {\n        message += ` in domain \"${domain}\"`\n      }\n      throw new ValidationError(\n        [\n          {\n            field: 'parents',\n            message,\n            rule: 'required',\n          },\n        ],\n        { message }\n      )\n    }\n    // Check for circular inheritance\n    if (this.hasCircularParent(effectiveKey)) {\n      const message = `Circular inheritance detected. Cannot add ${key} as a parent`\n      throw new ValidationError(\n        [\n          {\n            field: 'parents',\n            message,\n            rule: 'circular',\n          },\n        ],\n        { message }\n      )\n    }\n    if (graph.outEdges(this.key, effectiveKey).next().value) {\n      const message = `Parent ${key} already exists`\n      throw new ValidationError(\n        [\n          {\n            field: 'parents',\n            message,\n            rule: 'unique',\n          },\n        ],\n        { message }\n      )\n    }\n    // Parents are associated through graph edges.\n    // Otherwise it would collide with the parent model.\n    if (domain) {\n      graph.setEdge(this.key, effectiveKey, { type: 'parent', domain, foreign: true })\n    } else {\n      graph.setEdge(this.key, effectiveKey, { type: 'parent' })\n    }\n    this.root.notifyChange()\n    return this\n  }\n\n  /**\n   * Removes a parent from this entity.\n   *\n   * @param key The key of the parent entity to remove.\n   * @param domain Optional domain key if the parent belongs to a foreign domain.\n   * @returns `this` for chaining.\n   * @throws Error When the parent does not exist.\n   * @example\n   * ```typescript\n   * // Remove local parent\n   * entity.removeParent('baseEntity');\n   *\n   * // Remove foreign domain parent\n   * entity.removeParent('baseEntity', 'externalDomain');\n   * ```\n   */\n  removeParent(key: string, domain?: string): this {\n    const { graph } = this.root\n    const effectiveKey = this.domain.buildReferenceKey(key, domain)\n\n    if (!graph.hasEdge(this.key, effectiveKey)) {\n      let message = `Trying to remove a parent ${key} from ${this.key}, but it doesn't exist`\n      if (domain) {\n        message = `Trying to remove a foreign parent ${key} from domain \"${domain}\" from ${this.key}, but it doesn't exist`\n      }\n      throw new Error(message)\n    }\n\n    // Verify it's actually a parent edge\n    const edge = graph.edge(this.key, effectiveKey)\n    if (!edge || edge.type !== 'parent') {\n      let message = `Edge between ${this.key} and ${key} exists but is not a parent relationship`\n      if (domain) {\n        message = `Edge between ${this.key} and ${key} in domain \"${domain}\" exists but is not a parent relationship`\n      }\n      throw new Error(message)\n    }\n\n    graph.removeEdge(this.key, effectiveKey)\n    this.root.notifyChange()\n    return this\n  }\n\n  /**\n   * Checks if this entity has any parents.\n   *\n   * @returns True if the entity has parents.\n   * @example\n   * ```typescript\n   * if (entity.hasParents()) {\n   *   // ...\n   * }\n   * ```\n   */\n  hasParents(): boolean {\n    for (const edge of this.root.graph.outEdges(this.key)) {\n      if (this.root.graph.edge(edge)?.type === 'parent') {\n        return true\n      }\n    }\n    return false\n  }\n\n  /**\n   * Checks if the passed entity has a circular parent\n   * relationship when attempting to add a new parent.\n   *\n   * @param key The key of the parent being added.\n   * @returns True if adding this parent would create a\n   *   circular relationship.\n   */\n  hasCircularParent(key: string): boolean {\n    const { graph } = this.root\n\n    // Check if new parent is one of the children.\n    for (const edge of graph.outEdges(key, this.key)) {\n      if (graph.edge(edge)?.type === 'parent') {\n        return true\n      }\n    }\n\n    // check if this entity is in parents chain.\n    let current: DomainEntity | undefined = graph.node(key) as DomainEntity | undefined\n    while (current) {\n      if (current.key === this.key) {\n        return true\n      }\n      const parents = [...current.listParents()]\n      if (parents.length === 0) {\n        break\n      }\n      // Assuming single inheritance\n      // TODO: Update this to check for multiple parents.\n      current = parents[0]\n    }\n\n    return false\n  }\n\n  /**\n   * Creates breadcrumbs from this entity to the root\n   * namespace.\n   *\n   * @returns An array of `FileBreadcrumb` instances.\n   * @example\n   * ```typescript\n   * const breadcrumbs = entity.breadcrumbs();\n   * console.log(breadcrumbs);\n   * ```\n   */\n  breadcrumbs(): FileBreadcrumb[] {\n    const result: FileBreadcrumb[] = []\n    result.push({\n      key: this.key,\n      name: this.info.getLabel('Unnamed entity'),\n      kind: DomainEntityKind,\n    })\n    const model = this.getParentInstance()\n    if (model) {\n      result.push({\n        key: model.key,\n        kind: model.kind,\n        name: model.info.getLabel('Unnamed model'),\n      })\n      let parent: DataDomain | DomainNamespace = model.getParentInstance()\n      while (parent && parent !== this.root) {\n        result.push({\n          key: parent.key,\n          kind: parent.kind,\n          name: parent.info.getLabel('Unnamed namespace'),\n        })\n        const typed = parent as DomainNamespace\n        parent = typed.getParentInstance()\n      }\n    }\n    result.push({\n      key: this.root.key,\n      name: this.root.info.getLabel('Unnamed data domain'),\n      kind: this.root.kind,\n    })\n    return result.reverse()\n  }\n\n  /**\n   * Adds an association to this entity.\n   *\n   * Add rules:\n   * - If the target is specified, it has to exist in the graph.\n   * - The association targets can be local or foreign.\n   *\n   * Please note that you can't just add targets to the association schema.\n   * This function manipulates the graph to insert the required metadata.\n   *\n   * @param input The partial association schema.\n   * @returns The created `DomainAssociation` instance.\n   * @throws Error When the target entity does not exist.\n   * @example\n   * ```typescript\n   * const association = entity.addAssociation({ info: { name: 'Address' }, targets: [{ key: 'address' }] });\n   * ```\n   */\n  addAssociation(input: Partial<DomainAssociationSchema> = {}): DomainAssociation {\n    const { graph } = this.root\n\n    // clean up any target information from the input\n    // so we won't break the graph and the app.\n    const inputCopy = { ...input }\n    const targets = inputCopy.targets\n    delete inputCopy.targets\n\n    const hasTargets = Array.isArray(targets) && targets.length\n    if (hasTargets) {\n      for (const target of targets) {\n        if (target.domain && target.key) {\n          // target is foreign\n          const foreignKey = `${target.domain}:${target.key}`\n          if (!graph.hasNode(foreignKey)) {\n            throw new Error(`Foreign entity ${foreignKey} not found`)\n          }\n        } else if (target.key) {\n          if (!graph.hasNode(target.key)) {\n            throw new Error(`Target entity ${target.key} not found`)\n          }\n        }\n      }\n    }\n\n    const item = new DomainAssociation(this.root, this.key, inputCopy)\n    graph.setNode(item.key, item)\n    graph.setEdge(this.key, item.key, { type: 'association' })\n    if (hasTargets) {\n      for (const target of targets) {\n        item.addTarget(target.key, target.domain)\n      }\n    }\n    this.fields.push({ type: 'association', key: item.key })\n    this.root.notifyChange()\n    return item\n  }\n\n  /**\n   * Removes an association from this entity.\n   *\n   * @param key The key of the association to remove.\n   * @throws Error When the association does not exist.\n   * @example\n   * ```typescript\n   * entity.removeAssociation('address');\n   * ```\n   */\n  removeAssociation(key: string): void {\n    if (!this.root.graph.hasEdge(this.key, key)) {\n      throw new Error(`Unable to find a connection between this entity and the ${key} association`)\n    }\n    const edge = this.root.graph.edge(this.key, key)\n    if (!edge || edge.type !== 'association') {\n      throw new Error(`Association ${key} does not exist`)\n    }\n    removeGraphNode(this.root.graph, key)\n    this.removeField(key)\n    this.root.notifyChange()\n  }\n\n  /**\n   * A shortcut to `listAssociations()`.\n   */\n  get associations(): Generator<DomainAssociation> {\n    return this.listAssociations()\n  }\n\n  /**\n   * Lists all associations of this entity.\n   *\n   * The order of the associations is defined in the `fields` array.\n   *\n   * @returns A generator that yields each\n   *   `DomainAssociation`.\n   * @example\n   * ```typescript\n   * for (const association of entity.listAssociations()) {\n   *   console.log(association.key);\n   * }\n   * ```\n   */\n  *listAssociations(): Generator<DomainAssociation> {\n    for (const { key, type } of this.fields) {\n      if (type !== 'association') {\n        continue\n      }\n      const node = this.root.graph.node(key)\n      if (!node || node.kind !== DomainAssociationKind) {\n        continue\n      }\n      yield node\n    }\n  }\n\n  /**\n   * Checks if this entity has any associations.\n   *\n   * @returns True if the entity has associations.\n   * @example\n   * ```typescript\n   * if (entity.hasAssociations()) {\n   *   // ...\n   * }\n   * ```\n   */\n  hasAssociations(): boolean {\n    return this.fields.some((item) => item.type === 'association')\n  }\n\n  /**\n   * Lists all fields (properties and associations) of this entity.\n   *\n   * @returns A generator that yields each `DomainAssociation` or `DomainProperty`.\n   * @example\n   * ```typescript\n   * for (const field of entity.listFields()) {\n   *   console.log(field.key);\n   * }\n   * ```\n   */\n  *listFields(): Generator<DomainAssociation | DomainProperty> {\n    for (const { key } of this.fields) {\n      const node = this.root.graph.node(key)\n      if (!node) {\n        continue\n      }\n      if (node.kind === DomainAssociationKind || node.kind === DomainPropertyKind) {\n        yield node\n      }\n    }\n  }\n\n  /**\n   * Checks if this entity has any fields (properties or associations).\n   *\n   * @returns True if the entity has fields.\n   * @example\n   * ```typescript\n   * if (entity.hasFields()) {\n   *   // ...\n   * }\n   * ```\n   */\n  hasFields(): boolean {\n    return this.fields.length > 0\n  }\n\n  private removeField(key: string): void {\n    this.fields = this.fields.filter((item) => item.key !== key)\n  }\n\n  /**\n   * Creates an AMF's data Shape.\n   *\n   * The property itself is auto-generated. If the `schema` is defined then it is used\n   * as the `range` of the property. Otherwise basic shape is generated for the range.\n   *\n   * This is a preferred way of reading the AMF shape as this synchronizes changed\n   * data properties with the shape definition.\n   *\n   * @returns AMF property shape definition.\n   */\n  toApiShape(): Shapes.IShapeUnion {\n    const serializer = new ShapeGenerator()\n    return serializer.entity(this)\n  }\n\n  /**\n   * Reads the schema of the Entity and generates an example for it.\n   *\n   * @param mime The mime type of the example.\n   * @param opts The example generation options.\n   * @returns The generated example.\n   * @example\n   * ```typescript\n   * const example = entity.toExample('application/json');\n   * console.log(example);\n   * ```\n   */\n  toExample(mime: string, opts: IShapeRenderOptions = {}): string | number | boolean | null | undefined {\n    const shape = this.toApiShape()\n    const generator = new ApiSchemaGenerator(mime, {\n      renderExamples: opts.renderExamples ?? true,\n      renderMocked: opts.renderMocked ?? true,\n      renderOptional: opts.renderOptional ?? true,\n      selectedUnions: opts.selectedUnions,\n    })\n    return generator.generate(shape)\n  }\n\n  /**\n   * Checks whether the entity is a child of the given namespace or data model.\n   * The relationship doesn't have to be direct, as long as the entity\n   * is in the hierarchy it will return true.\n   *\n   * @param key The key of the parent to check.\n   * @returns True if this entity is a child of the given namespace or data model.\n   */\n  isChildOf(key: string): boolean {\n    if (this.key === key) {\n      return false\n    }\n    const parent = this.getParentInstance()\n    if (!parent) {\n      return false\n    }\n    if (parent.key === key) {\n      return true\n    }\n    return parent.isChildOf(key)\n  }\n\n  /**\n   * Finds the primary key property of this entity.\n   * @returns The primary key property of this entity or undefined if not found.\n   */\n  primaryKey(): DomainProperty | undefined {\n    for (const property of this.properties) {\n      if (property.primary) {\n        return property\n      }\n    }\n    let property: DomainProperty | undefined\n    for (const parent of this.listParents()) {\n      const prop = parent.primaryKey()\n      if (prop) {\n        // According to the validation rules, the last parent\n        // that has the property will be used as the source of\n        // the property.\n        // In the future, we may add a schema definition to the entity that\n        // will explicitly define which property to use.\n        property = prop\n      }\n    }\n    return property\n  }\n\n  /**\n   * Adds or updates a semantic to the entity.\n   * @param semantic The semantic to add to the entity.\n   * @throws Error if the semantic is not an entity semantic.\n   */\n  addSemantic(semantic: AppliedDataSemantic): void {\n    const sem = DataSemantics[semantic.id]\n    if (!isEntitySemantic(sem)) {\n      throw new Error(`Invalid semantic type: ${semantic.id}. Expected an entity semantic.`)\n    }\n    const index = this.semantics.findIndex((s) => s.id === semantic.id)\n    if (index >= 0) {\n      this.semantics[index] = semantic\n    } else {\n      this.semantics.push(semantic)\n    }\n    this.domain.notifyChange()\n  }\n\n  /**\n   * Removes a semantic from the entity.\n   * @param semanticId The ID of the semantic to remove.\n   */\n  removeSemantic(semanticId: SemanticType): void {\n    const index = this.semantics.findIndex((s) => s.id === semanticId)\n    if (index >= 0) {\n      this.semantics.splice(index, 1)\n      this.domain.notifyChange()\n    }\n  }\n\n  /**\n   * Checks if the entity has a specific semantic.\n   * @param semanticId The ID of the semantic to check.\n   * @returns True if the semantic is present, false otherwise.\n   */\n  hasSemantic(semanticId: SemanticType): boolean {\n    return this.semantics.some((s) => s.id === semanticId)\n  }\n\n  /**\n   * Generates a unique name by appending a number to the base name.\n   * @param baseName The base name to make unique.\n   * @returns A unique name within the current entity.\n   */\n  generateUniqueName(baseName: string): string {\n    const existingNames = new Set<string>()\n    for (const field of this.listFields()) {\n      if (field.info.name) {\n        existingNames.add(field.info.name)\n      }\n    }\n\n    let counter = 2\n    let newName = `${baseName}_copy`\n    while (existingNames.has(newName)) {\n      newName = `${baseName}_copy_${counter}`\n      counter++\n    }\n\n    return newName\n  }\n}\n"]}

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

@@ -1,6 +1,6 @@
 import { ExposedEntityKind } from '../models/kinds.js';
 import { Action } from './actions/Action.js';
-import { type ApiActionSchema } from './actions/index.js';
+import { ActionKind, type ApiActionSchema } from './actions/index.js';
 import type { ApiModel } from './ApiModel.js';
 import { AccessRule } from './rules/AccessRule.js';
 import { type RateLimitRule } from './rules/index.js';
@@ -160,6 +160,17 @@ export declare class ExposedEntity extends EventTarget {
      * @returns The added action.
      */
     addAction(schema: ApiActionSchema): Action;
+    /**
+     * @deprecated Use {@link addActionFromKind()} instead.
+     */
+    addCrudAction(actionKind: ActionKind): Action;
+    /**
+     * Adds an action of a given kind to the exposure.
+     *
+     * @param actionKind The kind of the action to add.
+     * @returns The added action.
+     */
+    addActionFromKind(actionKind: ActionKind): Action;
     /**
      * Scans for the indexed and search properties in the `DomainEntity`
      * and recreates the `paginationContract` with all indexed/searched fields.

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

@@ -1 +1 @@
-{"version":3,"file":"ExposedEntity.d.ts","sourceRoot":"","sources":["../../../src/modeling/ExposedEntity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,KAAK,eAAe,EAAiB,MAAM,oBAAoB,CAAA;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAA;AAChF,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,SAAQ,WAAW;;IAC5C;;OAEG;IACH,IAAI,EAAE,OAAO,iBAAiB,CAAA;IAE9B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;OAEG;IACS,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAE9C;;;;;;OAMG;IACH,aAAa,EAAE,OAAO,CAAA;IAEtB;;;OAGG;IACS,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAEvD;;;OAGG;IACS,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;;OAIG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;IAExB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B;;OAEG;IACS,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;IAEtC;;OAEG;IACS,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;IAEzD;;OAEG;IACS,QAAQ,CAAC,YAAY,EAAE,yBAAyB,GAAG,SAAS,CAAA;IAExE;;;;;OAKG;IACuB,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,CAAA;IAErF;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAcnB;;OAEG;IACH,GAAG,EAAE,QAAQ,CAAA;IAEb,MAAM,CAAC,YAAY,CAAC,KAAK,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAAG,mBAAmB;gBAmDtE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAyBjE,YAAY;IAaZ,MAAM,IAAI,mBAAmB;IAoC7B;;;;;;;;OAQG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM;IA4C9B;;;;;;;;OAQG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM;IA6E5B;;;;;OAKG;IACH,uBAAuB,IAAI,MAAM;IAcjC;;;;;;OAMG;IACH,yBAAyB,IAAI,MAAM,GAAG,SAAS;IAe/C;;OAEG;IACH,WAAW,IAAI,UAAU,EAAE;IAc3B;;OAEG;IACH,kBAAkB,IAAI,yBAAyB,EAAE;IAgBjD;;;OAGG;IACH,sBAAsB,IAAI,aAAa,EAAE;IAgBzC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;IAY1C;;;;;;;OAOG;IACH,wBAAwB,IAAI,IAAI;CA+BjC"}
+{"version":3,"file":"ExposedEntity.d.ts","sourceRoot":"","sources":["../../../src/modeling/ExposedEntity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAuC,MAAM,oBAAoB,CAAA;AAC1G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAA;AAChF,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;;;;;;GAaG;AACH,qBAAa,aAAc,SAAQ,WAAW;;IAC5C;;OAEG;IACH,IAAI,EAAE,OAAO,iBAAiB,CAAA;IAE9B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;OAEG;IACS,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAE9C;;;;;;OAMG;IACH,aAAa,EAAE,OAAO,CAAA;IAEtB;;;OAGG;IACS,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;IAEvD;;;OAGG;IACS,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAEzC;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;;;OAIG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;IAExB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B;;OAEG;IACS,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAA;IAEtC;;OAEG;IACS,QAAQ,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;IAEzD;;OAEG;IACS,QAAQ,CAAC,YAAY,EAAE,yBAAyB,GAAG,SAAS,CAAA;IAExE;;;;;OAKG;IACuB,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,CAAA;IAErF;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IAcnB;;OAEG;IACH,GAAG,EAAE,QAAQ,CAAA;IAEb,MAAM,CAAC,YAAY,CAAC,KAAK,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAAG,mBAAmB;gBAmDtE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAyBjE,YAAY;IAaZ,MAAM,IAAI,mBAAmB;IAoC7B;;;;;;;;OAQG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM;IA4C9B;;;;;;;;OAQG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM;IA6E5B;;;;;OAKG;IACH,uBAAuB,IAAI,MAAM;IAcjC;;;;;;OAMG;IACH,yBAAyB,IAAI,MAAM,GAAG,SAAS;IAe/C;;OAEG;IACH,WAAW,IAAI,UAAU,EAAE;IAc3B;;OAEG;IACH,kBAAkB,IAAI,yBAAyB,EAAE;IAgBjD;;;OAGG;IACH,sBAAsB,IAAI,aAAa,EAAE;IAgBzC;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM;IAY1C;;OAEG;IACH,aAAa,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAI7C;;;;;OAKG;IACH,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAYjD;;;;;;;OAOG;IACH,wBAAwB,IAAI,IAAI;CA+BjC"}

package/build/src/modeling/ExposedEntity.js

@@ -3,7 +3,7 @@ import { observed, toRaw } from '../decorators/observed.js';
 import { Exception } from '../exceptions/exception.js';
 import { ExposedEntityKind } from '../models/kinds.js';
 import { nanoid } from '../nanoid.js';
-import { restoreAction } from './actions/index.js';
+import { createActionFromKind, restoreAction } from './actions/index.js';
 import { ensureLeadingSlash, joinPaths } from './helpers/endpointHelpers.js';
 import { restoreAccessRule } from './rules/index.js';
 import { RateLimitingConfiguration } from './rules/RateLimitingConfiguration.js';
@@ -511,6 +511,29 @@ let ExposedEntity = (() => {
             this.actions.push(action);
             return action;
         }
+        /**
+         * @deprecated Use {@link addActionFromKind()} instead.
+         */
+        addCrudAction(actionKind) {
+            return this.addActionFromKind(actionKind);
+        }
+        /**
+         * Adds an action of a given kind to the exposure.
+         *
+         * @param actionKind The kind of the action to add.
+         * @returns The added action.
+         */
+        addActionFromKind(actionKind) {
+            if (this.actions.some((action) => action.kind === actionKind)) {
+                throw new Exception(`Action of kind "${actionKind}" already exists for this exposure`, {
+                    code: 'E_ACTION_USED',
+                    help: "There's no need to add an API action again.",
+                });
+            }
+            const action = createActionFromKind(this, actionKind);
+            this.actions.push(action);
+            return action;
+        }
         /**
          * Scans for the indexed and search properties in the `DomainEntity`
          * and recreates the `paginationContract` with all indexed/searched fields.

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, toRaw } from '../decorators/observed.js'\nimport { Exception } from '../exceptions/exception.js'\nimport { ExposedEntityKind } from '../models/kinds.js'\nimport { nanoid } from '../nanoid.js'\nimport { Action } from './actions/Action.js'\nimport { type ApiActionSchema, 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 {\n  AssociationTarget,\n  ExposeOptions,\n  ExposeParentRef,\n  ExposedEntitySchema,\n  PaginationContract,\n} 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() accessor actions: Action[]\n\n  /**\n   * Optional array of access rules that define the access control policies for this exposure.\n   */\n  @observed() 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   * Pagination contract for this exposure.\n   * Defines a list of fields that can be used for filtering, sorting, and searching.\n   * The pagination contract is only valid for that specific exposure. It cannot be inherited\n   * by other exposures.\n   */\n  @observed({ deep: true }) accessor paginationContract: PaginationContract | 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      paginationContract,\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    if (paginationContract !== undefined) {\n      result.paginationContract = structuredClone(paginationContract)\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(this, ar)) : []\n    if (init.rateLimiting) {\n      this.rateLimiting = new RateLimitingConfiguration(init.rateLimiting)\n    }\n    this.truncated = init.truncated\n    if (init.paginationContract) {\n      this.paginationContract = structuredClone(init.paginationContract)\n    }\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      this.api.notifyChange()\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    if (this.paginationContract) {\n      result.paginationContract = structuredClone(toRaw(this, this.paginationContract))\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 Exception(`Cannot set collection path on an exposure that does not have a collection`, {\n        code: 'E_PATH_MISSING',\n        help: 'The exposed entity you are trying to set a collection path for does not have a collection.',\n      })\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 Exception(`Collection path must contain exactly one segment. Received: \"${path}\"`, {\n        code: 'E_PATH_SEGMENT_SIZE',\n        help: 'The set path must have a single path segment (e.g., `/products`)',\n      })\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 Exception(`Collection path \"${normalizedCollection}\" is already in use by another root entity.`, {\n          code: 'E_PATH_INUSE',\n          help: 'The set path is already in use by another root entity.',\n        })\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        // Why do we throw this error? We should just create it from the resource path...\n        throw new Exception('Cannot set resource path: missing collection path for this exposure', {\n          code: 'E_PATH_MISSING',\n          help: 'Set the collection path on the exposed entity first.',\n        })\n      }\n      const colSegments = this.collectionPath.split('/').filter(Boolean)\n      if (colSegments.length !== 1) {\n        throw new Exception(`Invalid stored collection path \"${this.collectionPath}\"`, {\n          code: 'E_PATH_SEGMENT_SIZE',\n          help: 'The set collection path must have a single path segment (e.g., `/products`)',\n        })\n      }\n      if (segments.length !== 2) {\n        throw new Exception(\n          `Resource path must be exactly two segments (collection + parameter). Received: \"${cleaned}\"`,\n          {\n            code: 'E_PATH_SEGMENT_SIZE',\n            help: 'The set resource path must have exactly two segments (collection + parameter).',\n          }\n        )\n      }\n      const [s1, s2] = segments\n      if (s1 !== colSegments[0]) {\n        throw new Exception(\n          `Resource path must start with the collection segment \"${colSegments[0]}\". Received: \"${s1}\"`,\n          {\n            code: 'E_PATH_MISMATCH',\n            help: 'Set the resource path to the same value as the collection path + the parameter value.',\n          }\n        )\n      }\n      // s2 must be a parameter segment {name}\n      if (!/^\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(s2)) {\n        throw new Exception(`The second segment must be a parameter in braces, e.g. {id}. Received: \"${s2}\"`, {\n          code: 'E_PARAMETER_INVALID',\n          help: 'Use the braces to surround the parameter name, e.g., {productId}.',\n        })\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 Exception(\n        `Resource path must contain exactly one segment when no collection is present. Received: \"${cleaned}\"`,\n        {\n          code: 'E_PATH_SEGMENT_SIZE',\n          help: 'The set resource path must have exactly one segment.',\n        }\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 Exception(`Resource path \"${cleaned}\" is already in use by another root entity.`, {\n          code: 'E_PATH_INUSE',\n          help: 'The set path is already in use by another root entity.',\n        })\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  /**\n   * Adds an action to the exposure.\n   * @param schema The schema of the action to add.\n   * @returns The added action.\n   */\n  addAction(schema: ApiActionSchema): Action {\n    if (this.actions.some((action) => action.kind === schema.kind)) {\n      throw new Exception(`Action of kind \"${schema.kind}\" already exists for this exposure`, {\n        code: 'E_ACTION_USED',\n        help: \"There's no need to add an API action again.\",\n      })\n    }\n    const action = restoreAction(this, schema)\n    this.actions.push(action)\n    return action\n  }\n\n  /**\n   * Scans for the indexed and search properties in the `DomainEntity`\n   * and recreates the `paginationContract` with all indexed/searched fields.\n   *\n   * Note, this is a destructive action designed as a helper function when creating\n   * an exposed entity to fill up default values. Should not be used if the user\n   * didn't request that.\n   */\n  createPaginationContract(): void {\n    const entity = this.api.domain?.findEntity(this.entity.key, this.entity.domain)\n    if (!entity) {\n      throw new Exception(`Entity \"${this.entity.key}\" not found\"`, {\n        code: 'E_ENTITY_NOT_FOUND',\n        help: 'The set entity does not exist.',\n      })\n    }\n    if (!this.paginationContract) {\n      this.paginationContract = {\n        filterableFields: [],\n        searchableFields: [],\n        sortableFields: [],\n      }\n    } else {\n      this.paginationContract.filterableFields = []\n      this.paginationContract.searchableFields = []\n      this.paginationContract.sortableFields = []\n    }\n    for (const prop of entity.properties) {\n      // indexed properties allow sorting and filtering in the List action.\n      if (prop.index) {\n        this.paginationContract.filterableFields.push(prop.key)\n        this.paginationContract.sortableFields.push(prop.key)\n      }\n      // search properties allow full-text search in the Search action.\n      if (prop.search) {\n        this.paginationContract.searchableFields.push(prop.key)\n      }\n    }\n  }\n}\n"]}
+{"version":3,"file":"ExposedEntity.js","sourceRoot":"","sources":["../../../src/modeling/ExposedEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import { observed, toRaw } from '../decorators/observed.js'\nimport { Exception } from '../exceptions/exception.js'\nimport { ExposedEntityKind } from '../models/kinds.js'\nimport { nanoid } from '../nanoid.js'\nimport { Action } from './actions/Action.js'\nimport { ActionKind, type ApiActionSchema, createActionFromKind, 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 {\n  AssociationTarget,\n  ExposeOptions,\n  ExposeParentRef,\n  ExposedEntitySchema,\n  PaginationContract,\n} 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() accessor actions: Action[]\n\n  /**\n   * Optional array of access rules that define the access control policies for this exposure.\n   */\n  @observed() 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   * Pagination contract for this exposure.\n   * Defines a list of fields that can be used for filtering, sorting, and searching.\n   * The pagination contract is only valid for that specific exposure. It cannot be inherited\n   * by other exposures.\n   */\n  @observed({ deep: true }) accessor paginationContract: PaginationContract | 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      paginationContract,\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    if (paginationContract !== undefined) {\n      result.paginationContract = structuredClone(paginationContract)\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(this, ar)) : []\n    if (init.rateLimiting) {\n      this.rateLimiting = new RateLimitingConfiguration(init.rateLimiting)\n    }\n    this.truncated = init.truncated\n    if (init.paginationContract) {\n      this.paginationContract = structuredClone(init.paginationContract)\n    }\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      this.api.notifyChange()\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    if (this.paginationContract) {\n      result.paginationContract = structuredClone(toRaw(this, this.paginationContract))\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 Exception(`Cannot set collection path on an exposure that does not have a collection`, {\n        code: 'E_PATH_MISSING',\n        help: 'The exposed entity you are trying to set a collection path for does not have a collection.',\n      })\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 Exception(`Collection path must contain exactly one segment. Received: \"${path}\"`, {\n        code: 'E_PATH_SEGMENT_SIZE',\n        help: 'The set path must have a single path segment (e.g., `/products`)',\n      })\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 Exception(`Collection path \"${normalizedCollection}\" is already in use by another root entity.`, {\n          code: 'E_PATH_INUSE',\n          help: 'The set path is already in use by another root entity.',\n        })\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        // Why do we throw this error? We should just create it from the resource path...\n        throw new Exception('Cannot set resource path: missing collection path for this exposure', {\n          code: 'E_PATH_MISSING',\n          help: 'Set the collection path on the exposed entity first.',\n        })\n      }\n      const colSegments = this.collectionPath.split('/').filter(Boolean)\n      if (colSegments.length !== 1) {\n        throw new Exception(`Invalid stored collection path \"${this.collectionPath}\"`, {\n          code: 'E_PATH_SEGMENT_SIZE',\n          help: 'The set collection path must have a single path segment (e.g., `/products`)',\n        })\n      }\n      if (segments.length !== 2) {\n        throw new Exception(\n          `Resource path must be exactly two segments (collection + parameter). Received: \"${cleaned}\"`,\n          {\n            code: 'E_PATH_SEGMENT_SIZE',\n            help: 'The set resource path must have exactly two segments (collection + parameter).',\n          }\n        )\n      }\n      const [s1, s2] = segments\n      if (s1 !== colSegments[0]) {\n        throw new Exception(\n          `Resource path must start with the collection segment \"${colSegments[0]}\". Received: \"${s1}\"`,\n          {\n            code: 'E_PATH_MISMATCH',\n            help: 'Set the resource path to the same value as the collection path + the parameter value.',\n          }\n        )\n      }\n      // s2 must be a parameter segment {name}\n      if (!/^\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(s2)) {\n        throw new Exception(`The second segment must be a parameter in braces, e.g. {id}. Received: \"${s2}\"`, {\n          code: 'E_PARAMETER_INVALID',\n          help: 'Use the braces to surround the parameter name, e.g., {productId}.',\n        })\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 Exception(\n        `Resource path must contain exactly one segment when no collection is present. Received: \"${cleaned}\"`,\n        {\n          code: 'E_PATH_SEGMENT_SIZE',\n          help: 'The set resource path must have exactly one segment.',\n        }\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 Exception(`Resource path \"${cleaned}\" is already in use by another root entity.`, {\n          code: 'E_PATH_INUSE',\n          help: 'The set path is already in use by another root entity.',\n        })\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  /**\n   * Adds an action to the exposure.\n   * @param schema The schema of the action to add.\n   * @returns The added action.\n   */\n  addAction(schema: ApiActionSchema): Action {\n    if (this.actions.some((action) => action.kind === schema.kind)) {\n      throw new Exception(`Action of kind \"${schema.kind}\" already exists for this exposure`, {\n        code: 'E_ACTION_USED',\n        help: \"There's no need to add an API action again.\",\n      })\n    }\n    const action = restoreAction(this, schema)\n    this.actions.push(action)\n    return action\n  }\n\n  /**\n   * @deprecated Use {@link addActionFromKind()} instead.\n   */\n  addCrudAction(actionKind: ActionKind): Action {\n    return this.addActionFromKind(actionKind)\n  }\n\n  /**\n   * Adds an action of a given kind to the exposure.\n   *\n   * @param actionKind The kind of the action to add.\n   * @returns The added action.\n   */\n  addActionFromKind(actionKind: ActionKind): Action {\n    if (this.actions.some((action) => action.kind === actionKind)) {\n      throw new Exception(`Action of kind \"${actionKind}\" already exists for this exposure`, {\n        code: 'E_ACTION_USED',\n        help: \"There's no need to add an API action again.\",\n      })\n    }\n    const action = createActionFromKind(this, actionKind)\n    this.actions.push(action)\n    return action\n  }\n\n  /**\n   * Scans for the indexed and search properties in the `DomainEntity`\n   * and recreates the `paginationContract` with all indexed/searched fields.\n   *\n   * Note, this is a destructive action designed as a helper function when creating\n   * an exposed entity to fill up default values. Should not be used if the user\n   * didn't request that.\n   */\n  createPaginationContract(): void {\n    const entity = this.api.domain?.findEntity(this.entity.key, this.entity.domain)\n    if (!entity) {\n      throw new Exception(`Entity \"${this.entity.key}\" not found\"`, {\n        code: 'E_ENTITY_NOT_FOUND',\n        help: 'The set entity does not exist.',\n      })\n    }\n    if (!this.paginationContract) {\n      this.paginationContract = {\n        filterableFields: [],\n        searchableFields: [],\n        sortableFields: [],\n      }\n    } else {\n      this.paginationContract.filterableFields = []\n      this.paginationContract.searchableFields = []\n      this.paginationContract.sortableFields = []\n    }\n    for (const prop of entity.properties) {\n      // indexed properties allow sorting and filtering in the List action.\n      if (prop.index) {\n        this.paginationContract.filterableFields.push(prop.key)\n        this.paginationContract.sortableFields.push(prop.key)\n      }\n      // search properties allow full-text search in the Search action.\n      if (prop.search) {\n        this.paginationContract.searchableFields.push(prop.key)\n      }\n    }\n  }\n}\n"]}

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

@@ -0,0 +1,52 @@
+import { ApiModel, type ApiModelSchema } from './ApiModel.js';
+import type { DataDomainSchema } from './DataDomain.js';
+import type { ActionKind } from './actions/index.js';
+import type { ExposedEntity } from './ExposedEntity.js';
+import type { Action } from './actions/Action.js';
+/**
+ * Identifies a specific exposed entity and its action kind.
+ */
+export interface RouteLookup {
+    exposedEntityKey: string;
+    actionKind: ActionKind;
+}
+/**
+ * A routing definition mapping a path to an action lookup.
+ */
+export interface RouteDefinition {
+    path: string;
+    lookup: RouteLookup;
+}
+/**
+ * A map of HTTP methods to their route definitions.
+ */
+export type RoutingMap = Record<string, RouteDefinition[]>;
+/**
+ * Schema for an API Model optimized for runtime routing.
+ */
+export interface RuntimeApiModelSchema extends ApiModelSchema {
+    routingMap: RoutingMap;
+}
+export interface RuntimeResolvedAction {
+    entity: ExposedEntity;
+    action: Action;
+    params: Record<string, string>;
+}
+/**
+ * An optimized API Model subclass designed for fast runtime lookups.
+ * It pre-compiles the RoutingMap into a radix tree for O(log N) or faster endpoint resolution.
+ */
+export declare class RuntimeApiModel extends ApiModel {
+    #private;
+    constructor(schema: RuntimeApiModelSchema, domainSchema: DataDomainSchema);
+    /**
+     * Looks up the corresponding exposed entity and action for a given request.
+     *
+     * @param method The HTTP method (e.g., 'GET', 'POST').
+     * @param path The request path (e.g., '/users/123').
+     * @returns An object with the entity, action, and extracted path parameters if a match is found.
+     */
+    lookupAction(method: string, path: string): RuntimeResolvedAction | undefined;
+    toJSON(): RuntimeApiModelSchema;
+}
+//# sourceMappingURL=RuntimeApiModel.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeApiModel.d.ts","sourceRoot":"","sources":["../../../src/modeling/RuntimeApiModel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAEjD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB,EAAE,MAAM,CAAA;IACxB,UAAU,EAAE,UAAU,CAAA;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,WAAW,CAAA;CACpB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAA;AAE1D;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,cAAc;IAC3D,UAAU,EAAE,UAAU,CAAA;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,aAAa,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED;;;GAGG;AACH,qBAAa,eAAgB,SAAQ,QAAQ;;gBAY/B,MAAM,EAAE,qBAAqB,EAAE,YAAY,EAAE,gBAAgB;IAuBzE;;;;;;OAMG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAoCpE,MAAM,IAAI,qBAAqB;CAazC"}