@api-client/core 0.11.2 → 0.11.4

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

@@ -219,17 +219,11 @@ export declare class DataAssociation {
      */
     addTarget(entity: IDataEntity | string, namespace?: string): void;
     /**
-     * Removes a target entity from the association.
+     * Removes a target entity from the targets list.
      *
-     * @param entity - The `DataEntity` or `IDataEntity` instance to remove.
+     * @param init The key of an entity, its instance, or schema.
      */
-    removeTarget(entity: DataEntity | IDataEntity): void;
-    /**
-     * Removes a target entity from the association.
-     *
-     * @param key - The key of the target entity to remove.
-     */
-    removeTarget(key: string): void;
+    removeTarget(init: string | DataEntity | IDataEntity): void;
     /**
      * Creates a Property Shape of AMF.
      * The property itself is auto-generated. If the `schema` is defined then it is used

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

@@ -1 +1 @@
-{"version":3,"file":"DataAssociation.d.ts","sourceRoot":"","sources":["../../../src/modeling/DataAssociation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAA;AAEtF,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAA;AACpG,OAAO,EAA2B,KAAK,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAEtF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,OAAO,mBAAmB,CAAA;IAChC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC7B;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAA;CAChC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,qBAAa,eAAe;IA0FjB,IAAI,EAAE,aAAa;IAzF5B,IAAI,SAAsB;IAE1B,GAAG,SAAK;IAER;;OAEG;IACH,IAAI,EAAE,KAAK,CAAqB;IAEhC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB;;;;OAIG;IACH,OAAO,EAAE,iBAAiB,EAAE,CAAK;IAEjC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAE7B;;;;;;OAMG;IACH,QAAQ,EAAE,kBAAkB,EAAE,CAAK;IAEnC;;OAEG;IACH,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,eAAe;IAY3F;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe;IAMnE;;OAEG;gBAEM,IAAI,EAAE,aAAa,EAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,gBAAgB;IA2BnC;;;;OAIG;IACH,GAAG,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI;IAsCjC;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI;IA8BrC;;;;OAIG;IACH,MAAM,IAAI,gBAAgB;IAwB1B;;;;OAIG;IACH,UAAU,IAAI,UAAU,EAAE;IAK1B;;OAEG;IACH,MAAM,IAAI,IAAI;IAad;;;;;OAKG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAEnC;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IA+BjE;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,IAAI;IAEpD;;;;OAIG;IAEH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAoB/B;;;;;;;;;OASG;IACH,UAAU,IAAI,iBAAiB;IAK/B;;;;OAIG;IACH,SAAS,IAAI,UAAU;IAMvB;;;OAGG;IACH,YAAY,IAAI,oBAAoB;IAOpC;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB;IAOxE;;;OAGG;IACH,aAAa,IAAI,sBAAsB;IASvC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,KAAK,GAAG,UAAU,GAAG,mBAAmB,GAAG,SAAS;CAIvE"}
+{"version":3,"file":"DataAssociation.d.ts","sourceRoot":"","sources":["../../../src/modeling/DataAssociation.ts"],"names":[],"mappings":"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"}

package/build/src/modeling/DataAssociation.js

@@ -288,6 +288,8 @@ export class DataAssociation {
     }
     /**
      * @param init The key of an entity, its instance, or schema.
+     * @param namespace - The key of the foreign namespace this entity belongs to.
+     *      Do not set this value for local entities.
      */
     addTarget(init, namespace) {
         let key;

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

@@ -1 +1 @@
-{"version":3,"file":"DataAssociation.js","sourceRoot":"","sources":["../../../src/modeling/DataAssociation.ts"],"names":[],"mappings":"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","sourcesContent":["import { Json } from '@api-client/json'\nimport { AmfShapeGenerator } from '../amf/AmfShapeGenerator.js'\nimport { IApiAssociationShape, IApiPropertyShape } from '../amf/definitions/Shapes.js'\nimport v4 from '../lib/uuid.js'\nimport { IThing, Thing } from '../models/Thing.js'\nimport { DataEntity, IDataEntity } from './DataEntity.js'\nimport { DataNamespace } from './DataNamespace.js'\nimport { type FieldValidationMessage, ValidationError } from '../exceptions/validation_error.js'\nimport { DataAssociationKind } from '../models/kinds.js'\nimport type { AssociationBinding, AssociationBindings, AssociationWebBindings } from './Bindings.js'\nimport { DataAttributeAttributes, type DataAttributeAttribute } from './DataFormat.js'\n\n/**\n * Describes association target of an entity\n */\nexport interface AssociationTarget {\n  /**\n   * The key of the associated entity.\n   */\n  key: string\n  /**\n   * The key of the namespace to look for entities.\n   * By default it is the current (root) namespace. When this is set the program\n   * will look into `foreign` of the root namespace for the definition\n   * of the entity.\n   */\n  namespace?: string\n}\n\n/**\n * Describes an association between entities. An association is another property of an entity.\n * The `name` is the name of the property and the value is the associated target or targets.\n *\n * An association can have multiple targets to allow describing the model as `allOf`, `anyOf` and `oneOf` schemas.\n * When the association has only one target, then generated schema cannot have union types.\n *\n * Depending on the schema translation an association can be embedded as a sub-object in the generated schema\n * or can be references via a primary key.\n */\nexport interface IDataAssociation {\n  kind: typeof DataAssociationKind\n  /**\n   * The key of the association.\n   */\n  key: string\n  /**\n   * The data association description.\n   */\n  info: IThing\n  /**\n   * Wether the data association is required.\n   */\n  required?: boolean\n  /**\n   * Whether the data association allows multiple items.\n   */\n  multiple?: boolean\n  /**\n   * The list of keys associated with the entity through this association.\n   * An association without a target is considered invalid and discarded when processing the values.\n   * When multiple associations are set then we are dealing with an union.\n   */\n  targets?: AssociationTarget[]\n  /**\n   * The schema allowing to translate the model into a specific format (like JSON, RAML, XML, etc.)\n   *\n   * When this is defined then it is used as the schema. When this is not defined it uses\n   * referenced entities schemas. Note, changes in the referenced entities may not be propagated\n   * to schemas altered by the user.\n   */\n  schema?: IApiAssociationShape\n  /**\n   * The list of bindings for this property.\n   *\n   * A binding defines a translation from a data model to a specific format.\n   * For example allows to define properties required to generate AMF shape and therefore RAML/OAS shapes for web APIs\n   * or a protocol buffer schema.\n   */\n  bindings?: AssociationBinding[]\n}\n\n/**\n * Describes an association between entities. An association is a relationship defined on an entity\n * that links it to one or more other entities. The association has a `name` which is used as the\n * property name in the context of the parent entity, and it connects to a set of `targets`\n * representing the associated entities.\n *\n * An association can have multiple targets to allow describing the model as `allOf`, `anyOf`, or `oneOf`\n * schemas. When the association has only one target, then the generated schema cannot have union types.\n *\n * Depending on the schema translation, an association can be embedded as a sub-object in the generated\n * schema, or it can be referenced via a primary key.\n *\n * ## Key Concepts\n *\n * - **Targets**: An association's `targets` specify the entities that this association points to.\n *     Each target is defined by:\n *     -   `key`: The key of the target entity.\n *     -   `namespace` (optional): The key of the namespace where the target entity is defined.\n *         If not specified, it defaults to the current namespace.\n *\n * -   **Cardinality**:\n *     -   `multiple` (boolean): Indicates whether the association allows multiple target entities.\n *         If `true`, it's a to-many relationship; otherwise, it's a to-one relationship.\n *\n * -   **Schema**:\n *     -   `schema` (optional): A custom schema for the association, allowing manual definition of the\n *         association's structure in specific formats (e.g., JSON, RAML, XML).\n *         When provided, this schema overrides the automatically generated schema based on the\n *         target entities.\n *         -   **Important**: If a custom schema is defined and changes are made to the referenced\n *             entities, those changes **will not** be automatically propagated to the custom schema.\n *             This means the custom schema may become outdated and no longer accurately reflect the\n *             structure of the target entities.\n *\n * - **Hidden**:\n *  - `hidden`: (boolean) Defines if this association is a part of the schema or not.\n */\nexport class DataAssociation {\n  kind = DataAssociationKind\n\n  key = ''\n\n  /**\n   * The description of the data association.\n   */\n  info: Thing = Thing.fromName('')\n\n  /**\n   * Wether the data association is required.\n   */\n  required?: boolean\n\n  /**\n   * Whether the data association allows multiple items.\n   */\n  multiple?: boolean\n\n  /**\n   * The list of keys associated with the entity through this association.\n   * An association without a target is considered invalid and discarded when processing the values.\n   * When multiple associations are set then we are dealing with an union.\n   */\n  targets: AssociationTarget[] = []\n\n  /**\n   * The schema allowing to translate the model into a specific format (like JSON, RAML, XML, etc.)\n   *\n   * When this is defined then it is used as the schema. When this is not defined it uses\n   * referenced entities schemas. Note, changes in the referenced entities may not be propagated\n   * to schemas altered by the user.\n   */\n  schema?: IApiAssociationShape\n\n  /**\n   * The list of bindings for this property.\n   *\n   * A binding defines a translation from a data model to a specific format.\n   * For example allows to define properties required to generate AMF shape and therefore RAML/OAS shapes for web APIs\n   * or a protocol buffer schema.\n   */\n  bindings: AssociationBinding[] = []\n\n  /**\n   * Returns true when the association has 0 or 1 targets.\n   */\n  get isSingle(): boolean {\n    return this.targets.length < 2\n  }\n\n  /**\n   * Creates an instance of DataAssociation from a target entity key.\n   * Note, this entity will have no name. The default name is used instead.\n   *\n   * @param root The namespace root.\n   * @param target The target entity key.\n   * @param namespace The optional key of the target association when different to the current one.\n   * @returns A new `DataAssociation` instance.\n   */\n  static fromTarget(root: DataNamespace, target: string, namespace?: string): DataAssociation {\n    const assoc = new DataAssociation(root)\n    const info: AssociationTarget = {\n      key: target,\n    }\n    if (namespace) {\n      info.namespace = namespace\n    }\n    assoc.targets = [info]\n    return assoc\n  }\n\n  /**\n   * Creates an instance of DataAssociation from a name, without defining a target.\n   *\n   * @param root The namespace root.\n   * @param name The name of the association.\n   * @returns A new `DataAssociation` instance.\n   */\n  static fromName(root: DataNamespace, name: string): DataAssociation {\n    const assoc = new DataAssociation(root)\n    assoc.info = Thing.fromName(name)\n    return assoc\n  }\n\n  /**\n   * @param input The data association definition to restore.\n   */\n  constructor(\n    public root: DataNamespace,\n    input?: string | IDataAssociation\n  ) {\n    let init: IDataAssociation\n    if (typeof input === 'string') {\n      try {\n        init = JSON.parse(input)\n      } catch {\n        throw new ValidationError([\n          {\n            field: '',\n            message: 'Unable to parse the data association input as JSON.',\n            rule: 'object_required',\n          },\n        ])\n      }\n    } else if (typeof input === 'object') {\n      init = input\n    } else {\n      init = {\n        kind: DataAssociationKind,\n        key: v4(),\n        info: Thing.fromName('Unnamed association').toJSON(),\n      }\n    }\n    this.new(init)\n  }\n\n  /**\n   * Initializes the association using provided data.\n   *\n   * @param init - The data association definition to restore.\n   */\n  new(init: IDataAssociation): this {\n    DataAssociation.validate(init)\n    const { info, key = v4(), kind = DataAssociationKind, schema, multiple, required, targets, bindings } = init\n    this.kind = kind\n    this.key = key\n    if (info) {\n      this.info = new Thing(info)\n    } else {\n      this.info = Thing.fromName('')\n    }\n    if (schema) {\n      this.schema = Json.clone(schema)\n    } else {\n      this.schema = undefined\n    }\n    if (typeof multiple === 'boolean') {\n      this.multiple = multiple\n    } else {\n      this.multiple = undefined\n    }\n    if (typeof required === 'boolean') {\n      this.required = required\n    } else {\n      this.required = undefined\n    }\n    if (Array.isArray(targets)) {\n      this.targets = targets.map((i) => ({ ...i }))\n    } else {\n      this.targets = []\n    }\n    if (Array.isArray(bindings)) {\n      this.bindings = bindings.map((i) => Json.clone(i))\n    } else {\n      this.bindings = []\n    }\n    return this\n  }\n\n  /**\n   * Validates if the input object is a valid `DataAssociation` definition.\n   * Throws a `ValidationError` if the input is invalid.\n   *\n   * @param input The object to validate.\n   * @throws {ValidationError} When the validation fails.\n   */\n  static validate(input: unknown): void {\n    const typed = input as IDataAssociation\n    const messages: FieldValidationMessage[] = []\n    if (!typed) {\n      messages.push({\n        field: '',\n        message: 'The input is required. None given',\n        rule: 'required',\n      })\n      throw new ValidationError(messages)\n    }\n    if (typed.kind !== DataAssociationKind) {\n      messages.push({\n        field: 'kind',\n        message: `The kind property must be ${DataAssociationKind}`,\n        rule: 'invalid',\n      })\n    }\n    if (typed.info && typeof typed.info !== 'object') {\n      messages.push({\n        field: 'info',\n        message: 'The info property must be an object',\n        rule: 'invalid',\n      })\n    }\n    if (messages.length) {\n      throw new ValidationError(messages)\n    }\n  }\n\n  /**\n   * Generates an object representing the association, suitable for serialization.\n   *\n   * @returns A plain object representation of the `DataAssociation`.\n   */\n  toJSON(): IDataAssociation {\n    const result: IDataAssociation = {\n      kind: DataAssociationKind,\n      key: this.key,\n      info: this.info.toJSON(),\n    }\n    if (this.schema) {\n      result.schema = Json.clone(this.schema)\n    }\n    if (typeof this.multiple === 'boolean') {\n      result.multiple = this.multiple\n    }\n    if (typeof this.required === 'boolean') {\n      result.required = this.required\n    }\n    if (Array.isArray(this.targets) && this.targets.length) {\n      result.targets = this.targets.map((i) => ({ ...i }))\n    }\n    if (Array.isArray(this.bindings) && this.bindings.length) {\n      result.bindings = this.bindings.map((i) => Json.clone(i))\n    }\n    return result\n  }\n\n  /**\n   * Retrieves the list of target entities.\n   *\n   * @returns An array of `DataEntity` instances representing the targets of this association.\n   */\n  getTargets(): DataEntity[] {\n    const { targets } = this\n    return this.root.findAssociatedEntities(targets).filter((i) => !!i) as DataEntity[]\n  }\n\n  /**\n   * Removes self from the parent entity and the namespace definition.\n   */\n  remove(): void {\n    const { root } = this\n    const entity = root.definitions.entities.find((i) => i.associations.some((j) => j === this))\n    if (entity) {\n      const assocIndex = entity.associations.findIndex((i) => i === this)\n      entity.associations.splice(assocIndex, 1)\n    }\n    const defIndex = this.root.definitions.associations.findIndex((i) => i.key === this.key)\n    if (defIndex >= 0) {\n      this.root.definitions.associations.splice(defIndex, 1)\n    }\n  }\n\n  /**\n   * Adds a target entity to the association.\n   * If the entity comes from another namespace then it is set as a foreign entity.\n   *\n   * @param entity - The `DataEntity` instance to add.\n   */\n  addTarget(entity: DataEntity): void\n\n  /**\n   * Adds a target entity to the association.\n   *\n   * @param entity - The `IDataEntity` definition or just its key.\n   * @param namespace - The key of the foreign namespace this entity belongs to.\n   *      Do not set this value for local entities.\n   */\n  addTarget(entity: IDataEntity | string, namespace?: string): void\n\n  /**\n   * @param init The key of an entity, its instance, or schema.\n   */\n  addTarget(init: string | DataEntity | IDataEntity, namespace?: string): void {\n    let key: string\n    if (typeof init === 'string') {\n      key = init\n    } else {\n      key = init.key\n      const typed = init as IDataEntity & { root?: DataNamespace }\n      if (!namespace && typed.root && typed.root !== this.root) {\n        namespace = typed.root.key\n      }\n    }\n    if (namespace && namespace !== this.root.key) {\n      const foreignNamespace = this.root.foreign.find((ns) => ns.key === namespace)\n      if (!foreignNamespace) {\n        throw new Error(`Foreign namespace \"${namespace}\" does not exist.`)\n      }\n    }\n    const info: AssociationTarget = {\n      key,\n    }\n    if (namespace) {\n      info.namespace = namespace\n    }\n    this.targets.push(info)\n  }\n\n  /**\n   * Removes a target entity from the association.\n   *\n   * @param entity - The `DataEntity` or `IDataEntity` instance to remove.\n   */\n  removeTarget(entity: DataEntity | IDataEntity): void\n\n  /**\n   * Removes a target entity from the association.\n   *\n   * @param key - The key of the target entity to remove.\n   */\n  // eslint-disable-next-line @typescript-eslint/unified-signatures\n  removeTarget(key: string): void\n\n  /**\n   * Removes a target entity from the targets list.\n   *\n   * @param init The key of an entity, its instance, or schema.\n   */\n  removeTarget(init: string | DataEntity | IDataEntity): void {\n    let key: string\n    if (typeof init === 'string') {\n      key = init\n    } else {\n      key = init.key\n    }\n    const index = this.targets.findIndex((i) => i.key === key)\n    if (index >= 0) {\n      this.targets.splice(index, 1)\n    }\n  }\n\n  /**\n   * Creates a Property Shape of AMF.\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(): IApiPropertyShape {\n    const serializer = new AmfShapeGenerator()\n    return serializer.associationProperty(this)\n  }\n\n  /**\n   * Retrieves the parent entity of this association.\n   *\n   * @returns The `DataEntity` instance that contains this association.\n   */\n  getParent(): DataEntity {\n    // this is forced as an association is only created when an entity is created\n    // so it has to be defined.\n    return this.root.definitions.entities.find((i) => i.associations.includes(this)) as DataEntity\n  }\n\n  /**\n   * Creates the `schema` object if missing and returns it.\n   * @returns The schema object.\n   */\n  ensureSchema(): IApiAssociationShape {\n    if (!this.schema) {\n      this.schema = {}\n    }\n    return this.schema\n  }\n\n  /**\n   * Checks whether the passed value is one of the supported data proprty attributes.\n   * @param value The value to test\n   * @returns True when the passed value is one of the supported data proprty attributes.\n   */\n  static isValidAttribute(value: unknown): value is DataAttributeAttribute {\n    if (typeof value !== 'string') {\n      return false\n    }\n    return DataAttributeAttributes.includes(value as DataAttributeAttribute)\n  }\n\n  /**\n   * Creates if not existing and returns web bindings definition.\n   * @returns The web binding definition\n   */\n  getWebBinding(): AssociationWebBindings {\n    let object = this.bindings.find((i) => i.type === 'web') as AssociationBinding | undefined\n    if (!object) {\n      object = { type: 'web', schema: {} } as AssociationBinding\n      this.bindings.push(object)\n    }\n    return object.schema as AssociationWebBindings\n  }\n\n  /**\n   * Returns the schema value of the binding, if any was created.\n   * @param type The type of the binding to read.\n   * @returns The binding schema, if any\n   */\n  readBinding(type: 'web' | 'protobuf'): AssociationBindings | undefined {\n    const item = this.bindings.find((i) => i.type === type) as AssociationBinding\n    return item?.schema\n  }\n}\n"]}
+{"version":3,"file":"DataAssociation.js","sourceRoot":"","sources":["../../../src/modeling/DataAssociation.ts"],"names":[],"mappings":"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","sourcesContent":["import { Json } from '@api-client/json'\nimport { AmfShapeGenerator } from '../amf/AmfShapeGenerator.js'\nimport { IApiAssociationShape, IApiPropertyShape } from '../amf/definitions/Shapes.js'\nimport v4 from '../lib/uuid.js'\nimport { IThing, Thing } from '../models/Thing.js'\nimport { DataEntity, IDataEntity } from './DataEntity.js'\nimport { DataNamespace } from './DataNamespace.js'\nimport { type FieldValidationMessage, ValidationError } from '../exceptions/validation_error.js'\nimport { DataAssociationKind } from '../models/kinds.js'\nimport type { AssociationBinding, AssociationBindings, AssociationWebBindings } from './Bindings.js'\nimport { DataAttributeAttributes, type DataAttributeAttribute } from './DataFormat.js'\n\n/**\n * Describes association target of an entity\n */\nexport interface AssociationTarget {\n  /**\n   * The key of the associated entity.\n   */\n  key: string\n  /**\n   * The key of the namespace to look for entities.\n   * By default it is the current (root) namespace. When this is set the program\n   * will look into `foreign` of the root namespace for the definition\n   * of the entity.\n   */\n  namespace?: string\n}\n\n/**\n * Describes an association between entities. An association is another property of an entity.\n * The `name` is the name of the property and the value is the associated target or targets.\n *\n * An association can have multiple targets to allow describing the model as `allOf`, `anyOf` and `oneOf` schemas.\n * When the association has only one target, then generated schema cannot have union types.\n *\n * Depending on the schema translation an association can be embedded as a sub-object in the generated schema\n * or can be references via a primary key.\n */\nexport interface IDataAssociation {\n  kind: typeof DataAssociationKind\n  /**\n   * The key of the association.\n   */\n  key: string\n  /**\n   * The data association description.\n   */\n  info: IThing\n  /**\n   * Wether the data association is required.\n   */\n  required?: boolean\n  /**\n   * Whether the data association allows multiple items.\n   */\n  multiple?: boolean\n  /**\n   * The list of keys associated with the entity through this association.\n   * An association without a target is considered invalid and discarded when processing the values.\n   * When multiple associations are set then we are dealing with an union.\n   */\n  targets?: AssociationTarget[]\n  /**\n   * The schema allowing to translate the model into a specific format (like JSON, RAML, XML, etc.)\n   *\n   * When this is defined then it is used as the schema. When this is not defined it uses\n   * referenced entities schemas. Note, changes in the referenced entities may not be propagated\n   * to schemas altered by the user.\n   */\n  schema?: IApiAssociationShape\n  /**\n   * The list of bindings for this property.\n   *\n   * A binding defines a translation from a data model to a specific format.\n   * For example allows to define properties required to generate AMF shape and therefore RAML/OAS shapes for web APIs\n   * or a protocol buffer schema.\n   */\n  bindings?: AssociationBinding[]\n}\n\n/**\n * Describes an association between entities. An association is a relationship defined on an entity\n * that links it to one or more other entities. The association has a `name` which is used as the\n * property name in the context of the parent entity, and it connects to a set of `targets`\n * representing the associated entities.\n *\n * An association can have multiple targets to allow describing the model as `allOf`, `anyOf`, or `oneOf`\n * schemas. When the association has only one target, then the generated schema cannot have union types.\n *\n * Depending on the schema translation, an association can be embedded as a sub-object in the generated\n * schema, or it can be referenced via a primary key.\n *\n * ## Key Concepts\n *\n * - **Targets**: An association's `targets` specify the entities that this association points to.\n *     Each target is defined by:\n *     -   `key`: The key of the target entity.\n *     -   `namespace` (optional): The key of the namespace where the target entity is defined.\n *         If not specified, it defaults to the current namespace.\n *\n * -   **Cardinality**:\n *     -   `multiple` (boolean): Indicates whether the association allows multiple target entities.\n *         If `true`, it's a to-many relationship; otherwise, it's a to-one relationship.\n *\n * -   **Schema**:\n *     -   `schema` (optional): A custom schema for the association, allowing manual definition of the\n *         association's structure in specific formats (e.g., JSON, RAML, XML).\n *         When provided, this schema overrides the automatically generated schema based on the\n *         target entities.\n *         -   **Important**: If a custom schema is defined and changes are made to the referenced\n *             entities, those changes **will not** be automatically propagated to the custom schema.\n *             This means the custom schema may become outdated and no longer accurately reflect the\n *             structure of the target entities.\n *\n * - **Hidden**:\n *  - `hidden`: (boolean) Defines if this association is a part of the schema or not.\n */\nexport class DataAssociation {\n  kind = DataAssociationKind\n\n  key = ''\n\n  /**\n   * The description of the data association.\n   */\n  info: Thing = Thing.fromName('')\n\n  /**\n   * Wether the data association is required.\n   */\n  required?: boolean\n\n  /**\n   * Whether the data association allows multiple items.\n   */\n  multiple?: boolean\n\n  /**\n   * The list of keys associated with the entity through this association.\n   * An association without a target is considered invalid and discarded when processing the values.\n   * When multiple associations are set then we are dealing with an union.\n   */\n  targets: AssociationTarget[] = []\n\n  /**\n   * The schema allowing to translate the model into a specific format (like JSON, RAML, XML, etc.)\n   *\n   * When this is defined then it is used as the schema. When this is not defined it uses\n   * referenced entities schemas. Note, changes in the referenced entities may not be propagated\n   * to schemas altered by the user.\n   */\n  schema?: IApiAssociationShape\n\n  /**\n   * The list of bindings for this property.\n   *\n   * A binding defines a translation from a data model to a specific format.\n   * For example allows to define properties required to generate AMF shape and therefore RAML/OAS shapes for web APIs\n   * or a protocol buffer schema.\n   */\n  bindings: AssociationBinding[] = []\n\n  /**\n   * Returns true when the association has 0 or 1 targets.\n   */\n  get isSingle(): boolean {\n    return this.targets.length < 2\n  }\n\n  /**\n   * Creates an instance of DataAssociation from a target entity key.\n   * Note, this entity will have no name. The default name is used instead.\n   *\n   * @param root The namespace root.\n   * @param target The target entity key.\n   * @param namespace The optional key of the target association when different to the current one.\n   * @returns A new `DataAssociation` instance.\n   */\n  static fromTarget(root: DataNamespace, target: string, namespace?: string): DataAssociation {\n    const assoc = new DataAssociation(root)\n    const info: AssociationTarget = {\n      key: target,\n    }\n    if (namespace) {\n      info.namespace = namespace\n    }\n    assoc.targets = [info]\n    return assoc\n  }\n\n  /**\n   * Creates an instance of DataAssociation from a name, without defining a target.\n   *\n   * @param root The namespace root.\n   * @param name The name of the association.\n   * @returns A new `DataAssociation` instance.\n   */\n  static fromName(root: DataNamespace, name: string): DataAssociation {\n    const assoc = new DataAssociation(root)\n    assoc.info = Thing.fromName(name)\n    return assoc\n  }\n\n  /**\n   * @param input The data association definition to restore.\n   */\n  constructor(\n    public root: DataNamespace,\n    input?: string | IDataAssociation\n  ) {\n    let init: IDataAssociation\n    if (typeof input === 'string') {\n      try {\n        init = JSON.parse(input)\n      } catch {\n        throw new ValidationError([\n          {\n            field: '',\n            message: 'Unable to parse the data association input as JSON.',\n            rule: 'object_required',\n          },\n        ])\n      }\n    } else if (typeof input === 'object') {\n      init = input\n    } else {\n      init = {\n        kind: DataAssociationKind,\n        key: v4(),\n        info: Thing.fromName('Unnamed association').toJSON(),\n      }\n    }\n    this.new(init)\n  }\n\n  /**\n   * Initializes the association using provided data.\n   *\n   * @param init - The data association definition to restore.\n   */\n  new(init: IDataAssociation): this {\n    DataAssociation.validate(init)\n    const { info, key = v4(), kind = DataAssociationKind, schema, multiple, required, targets, bindings } = init\n    this.kind = kind\n    this.key = key\n    if (info) {\n      this.info = new Thing(info)\n    } else {\n      this.info = Thing.fromName('')\n    }\n    if (schema) {\n      this.schema = Json.clone(schema)\n    } else {\n      this.schema = undefined\n    }\n    if (typeof multiple === 'boolean') {\n      this.multiple = multiple\n    } else {\n      this.multiple = undefined\n    }\n    if (typeof required === 'boolean') {\n      this.required = required\n    } else {\n      this.required = undefined\n    }\n    if (Array.isArray(targets)) {\n      this.targets = targets.map((i) => ({ ...i }))\n    } else {\n      this.targets = []\n    }\n    if (Array.isArray(bindings)) {\n      this.bindings = bindings.map((i) => Json.clone(i))\n    } else {\n      this.bindings = []\n    }\n    return this\n  }\n\n  /**\n   * Validates if the input object is a valid `DataAssociation` definition.\n   * Throws a `ValidationError` if the input is invalid.\n   *\n   * @param input The object to validate.\n   * @throws {ValidationError} When the validation fails.\n   */\n  static validate(input: unknown): void {\n    const typed = input as IDataAssociation\n    const messages: FieldValidationMessage[] = []\n    if (!typed) {\n      messages.push({\n        field: '',\n        message: 'The input is required. None given',\n        rule: 'required',\n      })\n      throw new ValidationError(messages)\n    }\n    if (typed.kind !== DataAssociationKind) {\n      messages.push({\n        field: 'kind',\n        message: `The kind property must be ${DataAssociationKind}`,\n        rule: 'invalid',\n      })\n    }\n    if (typed.info && typeof typed.info !== 'object') {\n      messages.push({\n        field: 'info',\n        message: 'The info property must be an object',\n        rule: 'invalid',\n      })\n    }\n    if (messages.length) {\n      throw new ValidationError(messages)\n    }\n  }\n\n  /**\n   * Generates an object representing the association, suitable for serialization.\n   *\n   * @returns A plain object representation of the `DataAssociation`.\n   */\n  toJSON(): IDataAssociation {\n    const result: IDataAssociation = {\n      kind: DataAssociationKind,\n      key: this.key,\n      info: this.info.toJSON(),\n    }\n    if (this.schema) {\n      result.schema = Json.clone(this.schema)\n    }\n    if (typeof this.multiple === 'boolean') {\n      result.multiple = this.multiple\n    }\n    if (typeof this.required === 'boolean') {\n      result.required = this.required\n    }\n    if (Array.isArray(this.targets) && this.targets.length) {\n      result.targets = this.targets.map((i) => ({ ...i }))\n    }\n    if (Array.isArray(this.bindings) && this.bindings.length) {\n      result.bindings = this.bindings.map((i) => Json.clone(i))\n    }\n    return result\n  }\n\n  /**\n   * Retrieves the list of target entities.\n   *\n   * @returns An array of `DataEntity` instances representing the targets of this association.\n   */\n  getTargets(): DataEntity[] {\n    const { targets } = this\n    return this.root.findAssociatedEntities(targets).filter((i) => !!i) as DataEntity[]\n  }\n\n  /**\n   * Removes self from the parent entity and the namespace definition.\n   */\n  remove(): void {\n    const { root } = this\n    const entity = root.definitions.entities.find((i) => i.associations.some((j) => j === this))\n    if (entity) {\n      const assocIndex = entity.associations.findIndex((i) => i === this)\n      entity.associations.splice(assocIndex, 1)\n    }\n    const defIndex = this.root.definitions.associations.findIndex((i) => i.key === this.key)\n    if (defIndex >= 0) {\n      this.root.definitions.associations.splice(defIndex, 1)\n    }\n  }\n\n  /**\n   * Adds a target entity to the association.\n   * If the entity comes from another namespace then it is set as a foreign entity.\n   *\n   * @param entity - The `DataEntity` instance to add.\n   */\n  addTarget(entity: DataEntity): void\n\n  /**\n   * Adds a target entity to the association.\n   *\n   * @param entity - The `IDataEntity` definition or just its key.\n   * @param namespace - The key of the foreign namespace this entity belongs to.\n   *      Do not set this value for local entities.\n   */\n  addTarget(entity: IDataEntity | string, namespace?: string): void\n\n  /**\n   * @param init The key of an entity, its instance, or schema.\n   * @param namespace - The key of the foreign namespace this entity belongs to.\n   *      Do not set this value for local entities.\n   */\n  addTarget(init: string | DataEntity | IDataEntity, namespace?: string): void {\n    let key: string\n    if (typeof init === 'string') {\n      key = init\n    } else {\n      key = init.key\n      const typed = init as IDataEntity & { root?: DataNamespace }\n      if (!namespace && typed.root && typed.root !== this.root) {\n        namespace = typed.root.key\n      }\n    }\n    if (namespace && namespace !== this.root.key) {\n      const foreignNamespace = this.root.foreign.find((ns) => ns.key === namespace)\n      if (!foreignNamespace) {\n        throw new Error(`Foreign namespace \"${namespace}\" does not exist.`)\n      }\n    }\n    const info: AssociationTarget = {\n      key,\n    }\n    if (namespace) {\n      info.namespace = namespace\n    }\n    this.targets.push(info)\n  }\n\n  /**\n   * Removes a target entity from the targets list.\n   *\n   * @param init The key of an entity, its instance, or schema.\n   */\n  removeTarget(init: string | DataEntity | IDataEntity): void {\n    let key: string\n    if (typeof init === 'string') {\n      key = init\n    } else {\n      key = init.key\n    }\n    const index = this.targets.findIndex((i) => i.key === key)\n    if (index >= 0) {\n      this.targets.splice(index, 1)\n    }\n  }\n\n  /**\n   * Creates a Property Shape of AMF.\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(): IApiPropertyShape {\n    const serializer = new AmfShapeGenerator()\n    return serializer.associationProperty(this)\n  }\n\n  /**\n   * Retrieves the parent entity of this association.\n   *\n   * @returns The `DataEntity` instance that contains this association.\n   */\n  getParent(): DataEntity {\n    // this is forced as an association is only created when an entity is created\n    // so it has to be defined.\n    return this.root.definitions.entities.find((i) => i.associations.includes(this)) as DataEntity\n  }\n\n  /**\n   * Creates the `schema` object if missing and returns it.\n   * @returns The schema object.\n   */\n  ensureSchema(): IApiAssociationShape {\n    if (!this.schema) {\n      this.schema = {}\n    }\n    return this.schema\n  }\n\n  /**\n   * Checks whether the passed value is one of the supported data proprty attributes.\n   * @param value The value to test\n   * @returns True when the passed value is one of the supported data proprty attributes.\n   */\n  static isValidAttribute(value: unknown): value is DataAttributeAttribute {\n    if (typeof value !== 'string') {\n      return false\n    }\n    return DataAttributeAttributes.includes(value as DataAttributeAttribute)\n  }\n\n  /**\n   * Creates if not existing and returns web bindings definition.\n   * @returns The web binding definition\n   */\n  getWebBinding(): AssociationWebBindings {\n    let object = this.bindings.find((i) => i.type === 'web') as AssociationBinding | undefined\n    if (!object) {\n      object = { type: 'web', schema: {} } as AssociationBinding\n      this.bindings.push(object)\n    }\n    return object.schema as AssociationWebBindings\n  }\n\n  /**\n   * Returns the schema value of the binding, if any was created.\n   * @param type The type of the binding to read.\n   * @returns The binding schema, if any\n   */\n  readBinding(type: 'web' | 'protobuf'): AssociationBindings | undefined {\n    const item = this.bindings.find((i) => i.type === type) as AssociationBinding\n    return item?.schema\n  }\n}\n"]}

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

@@ -1,6 +1,6 @@
 import { IThing, Thing } from '../models/Thing.js';
 import { DataEntity, IDataEntity } from './DataEntity.js';
-import { DataNamespace } from './DataNamespace.js';
+import type { DataItemAdaptingOptions, DataNamespace } from './DataNamespace.js';
 import { FileBreadcrumb } from '../models/store/File.js';
 import { DataModelKind } from '../models/kinds.js';
 /**
@@ -56,6 +56,15 @@ export declare class DataModel {
      * Removes self from the namespace with all entities.
      */
     remove(): void;
+    /**
+     * Adapts an entity to this data model.
+     * The entity must already be added to another data model within this namespace for it to be
+     * adapted to this data model.
+     * This method is used to change the data model of an entity.
+     * It will remove the entity from the previous data model and add it to this one.
+     * @param entity The entity to adapt.
+     */
+    adaptEntity(entity: DataEntity, opts?: DataItemAdaptingOptions): void;
     /**
      * Adds an entity to this data model.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"DataModel.d.ts","sourceRoot":"","sources":["../../../src/modeling/DataModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,aAAa,CAAA;IAC1B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IA0BX,IAAI,EAAE,aAAa;IAzB5B,IAAI,SAAgB;IAEpB,GAAG,SAAK;IAER;;OAEG;IACH,IAAI,EAAE,KAAK,CAAqB;IAEhC;;OAEG;IACH,QAAQ,EAAE,UAAU,EAAE,CAAK;IAE3B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS;IAM7D;;;OAGG;gBAEM,IAAI,EAAE,aAAa,EAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IAkB7B,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAwB3B,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAQ3C,MAAM,IAAI,UAAU;IAYpB,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI1D;;OAEG;IACH,MAAM,IAAI,IAAI;IAoBd;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU;IAc9D;;OAEG;IACH,SAAS,IAAI,aAAa,GAAG,SAAS;IAOtC;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;CAuBhC"}
+{"version":3,"file":"DataModel.d.ts","sourceRoot":"","sources":["../../../src/modeling/DataModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,aAAa,CAAA;IAC1B;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;IACX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAED;;;;;GAKG;AACH,qBAAa,SAAS;IA0BX,IAAI,EAAE,aAAa;IAzB5B,IAAI,SAAgB;IAEpB,GAAG,SAAK;IAER;;OAEG;IACH,IAAI,EAAE,KAAK,CAAqB;IAEhC;;OAEG;IACH,QAAQ,EAAE,UAAU,EAAE,CAAK;IAE3B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS;IAM7D;;;OAGG;gBAEM,IAAI,EAAE,aAAa,EAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU;IAkB7B,GAAG,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAwB3B,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAQ3C,MAAM,IAAI,UAAU;IAYpB,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI1D;;OAEG;IACH,MAAM,IAAI,IAAI;IAoBd;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,GAAE,uBAA4B,GAAG,IAAI;IA+BzE;;;;;OAKG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU;IAc9D;;OAEG;IACH,SAAS,IAAI,aAAa,GAAG,SAAS;IAOtC;;OAEG;IACH,WAAW,IAAI,cAAc,EAAE;CAuBhC"}

package/build/src/modeling/DataModel.js

@@ -113,6 +113,45 @@ export class DataModel {
             root.definitions.models.splice(index, 1);
         }
     }
+    /**
+     * Adapts an entity to this data model.
+     * The entity must already be added to another data model within this namespace for it to be
+     * adapted to this data model.
+     * This method is used to change the data model of an entity.
+     * It will remove the entity from the previous data model and add it to this one.
+     * @param entity The entity to adapt.
+     */
+    adaptEntity(entity, opts = {}) {
+        if (opts.index !== undefined) {
+            if (opts.index < 0) {
+                throw new Error(`The index ${opts.index} cannot be below 0.`);
+            }
+            if (opts.index >= this.entities.length) {
+                throw new Error(`The index ${opts.index} is not valid.`);
+            }
+        }
+        if (entity.root !== this.root) {
+            throw new Error(`The entity ${entity.key} is not in the same namespace as this data model.`);
+        }
+        if (entity.getParent() === this) {
+            throw new Error(`The entity ${entity.key} is already adapted by this data model.`);
+        }
+        const parent = entity.getParent();
+        if (!parent) {
+            throw new Error(`The entity ${entity.key} has no parent.`);
+        }
+        const index = parent.entities.findIndex((i) => i.key === entity.key);
+        if (index < 0) {
+            throw new Error(`The entity ${entity.key} is not in the parent data model.`);
+        }
+        parent.entities.splice(index, 1);
+        if (opts.index !== undefined) {
+            this.entities.splice(opts.index, 0, entity);
+        }
+        else {
+            this.entities.push(entity);
+        }
+    }
     /**
      * Adds an entity to this data model.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"DataModel.js","sourceRoot":"","sources":["../../../src/modeling/DataModel.ts"],"names":[],"mappings":"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","sourcesContent":["import { IThing, Thing } from '../models/Thing.js'\nimport v4 from '../lib/uuid.js'\nimport { DataEntity, IDataEntity } from './DataEntity.js'\nimport { DataNamespace } from './DataNamespace.js'\nimport { FileBreadcrumb } from '../models/store/File.js'\nimport { DataModelKind } from '../models/kinds.js'\n\n/**\n * Data model creates a logical structure around data entities.\n * It groups entities that represents a whole schema, like a Product data model\n * can have entities that describe: the product entity, price history entity,\n * product location, etc.\n */\nexport interface IDataModel {\n  kind: typeof DataModelKind\n  /**\n   * The key of the namespace.\n   */\n  key: string\n  /**\n   * The data model description.\n   */\n  info: IThing\n  /**\n   * The list of keys of entities that this data model contain.\n   */\n  entities?: string[]\n}\n\n/**\n * Data model creates a logical structure around data entities.\n * It groups entities that represents a whole schema, like a Product data model\n * can have entities that describe: the product entity, price history entity,\n * product location, etc.\n */\nexport class DataModel {\n  kind = DataModelKind\n\n  key = ''\n\n  /**\n   * The description of the data namespace.\n   */\n  info: Thing = Thing.fromName('')\n\n  /**\n   * The list of entities that this data model has.\n   */\n  entities: DataEntity[] = []\n\n  static fromName(root: DataNamespace, name: string): DataModel {\n    const entity = new DataModel(root)\n    entity.info = Thing.fromName(name)\n    return entity\n  }\n\n  /**\n   * @param root the root namespace.\n   * @param input The data model definition to restore.\n   */\n  constructor(\n    public root: DataNamespace,\n    input?: string | IDataModel\n  ) {\n    let init: IDataModel\n    if (typeof input === 'string') {\n      init = JSON.parse(input)\n    } else if (typeof input === 'object') {\n      init = input\n    } else {\n      init = {\n        kind: DataModelKind,\n        key: v4(),\n        info: Thing.fromName('').toJSON(),\n        entities: [],\n      }\n    }\n    this.new(init)\n  }\n\n  new(init: IDataModel): void {\n    if (!DataModel.isDataModel(init)) {\n      throw new Error(`Not a data model.`)\n    }\n    const { info, key = v4(), kind = DataModelKind, entities } = init\n    this.kind = kind\n    this.key = key\n    if (info) {\n      this.info = new Thing(info)\n    } else {\n      this.info = Thing.fromName('')\n    }\n\n    this.entities = []\n    if (Array.isArray(entities)) {\n      entities.forEach((key) => {\n        const value = this._readEntity(key)\n        if (value) {\n          this.entities.push(value)\n        }\n      })\n    }\n  }\n\n  static isDataModel(input: unknown): boolean {\n    const typed = input as IDataModel\n    if (!input || typed.kind !== DataModelKind) {\n      return false\n    }\n    return true\n  }\n\n  toJSON(): IDataModel {\n    const result: IDataModel = {\n      kind: DataModelKind,\n      key: this.key,\n      info: this.info.toJSON(),\n    }\n    if (Array.isArray(this.entities) && this.entities.length) {\n      result.entities = this.entities.map((i) => i.key)\n    }\n    return result\n  }\n\n  protected _readEntity(key: string): DataEntity | undefined {\n    return this.root.definitions.entities.find((i) => i.key === key)\n  }\n\n  /**\n   * Removes self from the namespace with all entities.\n   */\n  remove(): void {\n    const { key, entities, root } = this\n    // remove children\n    entities.forEach((e) => e.remove())\n\n    // remove self from the parent\n    const parent = this.getParent()\n    if (parent) {\n      const itemIndex = parent.items.findIndex((i) => i.key === key)\n      if (itemIndex >= 0) {\n        parent.items.splice(itemIndex, 1)\n      }\n    }\n    // remove self from definitions\n    const index = root.definitions.models.findIndex((i) => i.key === key)\n    if (index >= 0) {\n      root.definitions.models.splice(index, 1)\n    }\n  }\n\n  /**\n   * Adds an entity to this data model.\n   *\n   * @param init The name of the entity to create, the instance of the entity or its schema\n   * @returns A reference to the created entity.\n   */\n  addEntity(init: string | DataEntity | IDataEntity): DataEntity {\n    let definition: DataEntity\n    if (typeof init === 'string') {\n      definition = DataEntity.fromName(this.root, init)\n    } else if (init instanceof DataEntity) {\n      definition = init\n    } else {\n      definition = new DataEntity(this.root, init)\n    }\n    this.root.definitions.entities.push(definition)\n    this.entities.push(definition)\n    return definition\n  }\n\n  /**\n   * Returns the parent namespace where this data model exist.\n   */\n  getParent(): DataNamespace | undefined {\n    if (this.root.items.some((e) => e.key === this.key)) {\n      return this.root\n    }\n    return this.root.definitions.namespaces.find((n) => n.items.some((e) => e.key === this.key))\n  }\n\n  /**\n   * Creates breadcrumbs from this data model to the root namespace.\n   */\n  breadcrumbs(): FileBreadcrumb[] {\n    const result: FileBreadcrumb[] = []\n    result.push({\n      key: this.key,\n      name: this.info.name || 'Unnamed data model',\n      kind: DataModelKind,\n    })\n    let parent = this.getParent()\n    while (parent && parent !== this.root) {\n      result.push({\n        key: parent.key,\n        kind: parent.kind,\n        name: parent.info.name || 'Unnamed namespace',\n      })\n      parent = parent.getParent()\n    }\n    result.push({\n      key: this.root.key,\n      name: this.root.info.name || 'Unnamed namespace',\n      kind: this.root.kind,\n    })\n    return result.reverse()\n  }\n}\n"]}
+{"version":3,"file":"DataModel.js","sourceRoot":"","sources":["../../../src/modeling/DataModel.ts"],"names":[],"mappings":"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","sourcesContent":["import { IThing, Thing } from '../models/Thing.js'\nimport v4 from '../lib/uuid.js'\nimport { DataEntity, IDataEntity } from './DataEntity.js'\nimport type { DataItemAdaptingOptions, DataNamespace } from './DataNamespace.js'\nimport { FileBreadcrumb } from '../models/store/File.js'\nimport { DataModelKind } from '../models/kinds.js'\n\n/**\n * Data model creates a logical structure around data entities.\n * It groups entities that represents a whole schema, like a Product data model\n * can have entities that describe: the product entity, price history entity,\n * product location, etc.\n */\nexport interface IDataModel {\n  kind: typeof DataModelKind\n  /**\n   * The key of the namespace.\n   */\n  key: string\n  /**\n   * The data model description.\n   */\n  info: IThing\n  /**\n   * The list of keys of entities that this data model contain.\n   */\n  entities?: string[]\n}\n\n/**\n * Data model creates a logical structure around data entities.\n * It groups entities that represents a whole schema, like a Product data model\n * can have entities that describe: the product entity, price history entity,\n * product location, etc.\n */\nexport class DataModel {\n  kind = DataModelKind\n\n  key = ''\n\n  /**\n   * The description of the data namespace.\n   */\n  info: Thing = Thing.fromName('')\n\n  /**\n   * The list of entities that this data model has.\n   */\n  entities: DataEntity[] = []\n\n  static fromName(root: DataNamespace, name: string): DataModel {\n    const entity = new DataModel(root)\n    entity.info = Thing.fromName(name)\n    return entity\n  }\n\n  /**\n   * @param root the root namespace.\n   * @param input The data model definition to restore.\n   */\n  constructor(\n    public root: DataNamespace,\n    input?: string | IDataModel\n  ) {\n    let init: IDataModel\n    if (typeof input === 'string') {\n      init = JSON.parse(input)\n    } else if (typeof input === 'object') {\n      init = input\n    } else {\n      init = {\n        kind: DataModelKind,\n        key: v4(),\n        info: Thing.fromName('').toJSON(),\n        entities: [],\n      }\n    }\n    this.new(init)\n  }\n\n  new(init: IDataModel): void {\n    if (!DataModel.isDataModel(init)) {\n      throw new Error(`Not a data model.`)\n    }\n    const { info, key = v4(), kind = DataModelKind, entities } = init\n    this.kind = kind\n    this.key = key\n    if (info) {\n      this.info = new Thing(info)\n    } else {\n      this.info = Thing.fromName('')\n    }\n\n    this.entities = []\n    if (Array.isArray(entities)) {\n      entities.forEach((key) => {\n        const value = this._readEntity(key)\n        if (value) {\n          this.entities.push(value)\n        }\n      })\n    }\n  }\n\n  static isDataModel(input: unknown): boolean {\n    const typed = input as IDataModel\n    if (!input || typed.kind !== DataModelKind) {\n      return false\n    }\n    return true\n  }\n\n  toJSON(): IDataModel {\n    const result: IDataModel = {\n      kind: DataModelKind,\n      key: this.key,\n      info: this.info.toJSON(),\n    }\n    if (Array.isArray(this.entities) && this.entities.length) {\n      result.entities = this.entities.map((i) => i.key)\n    }\n    return result\n  }\n\n  protected _readEntity(key: string): DataEntity | undefined {\n    return this.root.definitions.entities.find((i) => i.key === key)\n  }\n\n  /**\n   * Removes self from the namespace with all entities.\n   */\n  remove(): void {\n    const { key, entities, root } = this\n    // remove children\n    entities.forEach((e) => e.remove())\n\n    // remove self from the parent\n    const parent = this.getParent()\n    if (parent) {\n      const itemIndex = parent.items.findIndex((i) => i.key === key)\n      if (itemIndex >= 0) {\n        parent.items.splice(itemIndex, 1)\n      }\n    }\n    // remove self from definitions\n    const index = root.definitions.models.findIndex((i) => i.key === key)\n    if (index >= 0) {\n      root.definitions.models.splice(index, 1)\n    }\n  }\n\n  /**\n   * Adapts an entity to this data model.\n   * The entity must already be added to another data model within this namespace for it to be\n   * adapted to this data model.\n   * This method is used to change the data model of an entity.\n   * It will remove the entity from the previous data model and add it to this one.\n   * @param entity The entity to adapt.\n   */\n  adaptEntity(entity: DataEntity, opts: DataItemAdaptingOptions = {}): void {\n    if (opts.index !== undefined) {\n      if (opts.index < 0) {\n        throw new Error(`The index ${opts.index} cannot be below 0.`)\n      }\n      if (opts.index >= this.entities.length) {\n        throw new Error(`The index ${opts.index} is not valid.`)\n      }\n    }\n    if (entity.root !== this.root) {\n      throw new Error(`The entity ${entity.key} is not in the same namespace as this data model.`)\n    }\n    if (entity.getParent() === this) {\n      throw new Error(`The entity ${entity.key} is already adapted by this data model.`)\n    }\n    const parent = entity.getParent()\n    if (!parent) {\n      throw new Error(`The entity ${entity.key} has no parent.`)\n    }\n    const index = parent.entities.findIndex((i) => i.key === entity.key)\n    if (index < 0) {\n      throw new Error(`The entity ${entity.key} is not in the parent data model.`)\n    }\n    parent.entities.splice(index, 1)\n    if (opts.index !== undefined) {\n      this.entities.splice(opts.index, 0, entity)\n    } else {\n      this.entities.push(entity)\n    }\n  }\n\n  /**\n   * Adds an entity to this data model.\n   *\n   * @param init The name of the entity to create, the instance of the entity or its schema\n   * @returns A reference to the created entity.\n   */\n  addEntity(init: string | DataEntity | IDataEntity): DataEntity {\n    let definition: DataEntity\n    if (typeof init === 'string') {\n      definition = DataEntity.fromName(this.root, init)\n    } else if (init instanceof DataEntity) {\n      definition = init\n    } else {\n      definition = new DataEntity(this.root, init)\n    }\n    this.root.definitions.entities.push(definition)\n    this.entities.push(definition)\n    return definition\n  }\n\n  /**\n   * Returns the parent namespace where this data model exist.\n   */\n  getParent(): DataNamespace | undefined {\n    if (this.root.items.some((e) => e.key === this.key)) {\n      return this.root\n    }\n    return this.root.definitions.namespaces.find((n) => n.items.some((e) => e.key === this.key))\n  }\n\n  /**\n   * Creates breadcrumbs from this data model to the root namespace.\n   */\n  breadcrumbs(): FileBreadcrumb[] {\n    const result: FileBreadcrumb[] = []\n    result.push({\n      key: this.key,\n      name: this.info.name || 'Unnamed data model',\n      kind: DataModelKind,\n    })\n    let parent = this.getParent()\n    while (parent && parent !== this.root) {\n      result.push({\n        key: parent.key,\n        kind: parent.kind,\n        name: parent.info.name || 'Unnamed namespace',\n      })\n      parent = parent.getParent()\n    }\n    result.push({\n      key: this.root.key,\n      name: this.root.info.name || 'Unnamed namespace',\n      kind: this.root.kind,\n    })\n    return result.reverse()\n  }\n}\n"]}

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

@@ -5,6 +5,12 @@ import { IDataModel, DataModel } from './DataModel.js';
 import { IDataProperty, DataProperty } from './DataProperty.js';
 import { DataNamespaceKind, DataModelKind } from '../models/kinds.js';
 type ItemKind = typeof DataNamespaceKind | typeof DataModelKind;
+export interface DataItemAdaptingOptions {
+    /**
+     * The index at which to adapt the item.
+     */
+    index?: number;
+}
 interface IDataDefinitions {
     models?: IDataModel[];
     entities?: IDataEntity[];
@@ -35,7 +41,7 @@ interface DataDefinitions {
 }
 /**
  * Data definition for a foreign namespace.
- * Each foreigh namespace is resolved to a specific version.
+ * Each foreign namespace is resolved to a specific version.
  * This makes sure that the local data are always referencing an existing
  * entity as breaking changes should be resolved when upgrading a version.
  */
@@ -167,6 +173,11 @@ export declare class DataNamespace extends DataNamespaceParent {
     constructor(input?: string | IDataNamespace, root?: DataNamespace);
     new(init: IDataNamespace): void;
     toJSON(): IDataNamespace;
+    /**
+     * Checks if this is the root namespace.
+     * @returns True if this is the root namespace.
+     */
+    isRoot(): boolean;
     /**
      * Finds a parent namespace for the given namespace.
      * @param key The namespace key to find the parent for.
@@ -179,6 +190,14 @@ export declare class DataNamespace extends DataNamespaceParent {
      * @param parent The optional key of the parent namespace to add the new namespace to.
      */
     addNamespace(init: string | IDataNamespace | DataNamespace, parent?: string): DataNamespace;
+    /**
+     * Adapts an existing namespace to this namespace.
+     * This will remove the namespace from the parent namespace and add it to this one.
+     *
+     * @param ns The namespace to adapt.
+     * @param opts Adapting options.
+     */
+    adaptNamespace(ns: DataNamespace, opts?: DataItemAdaptingOptions): void;
     /**
      * Finds a namespace in the definitions.
      * @param key The key of the namespace to find.
@@ -259,6 +278,17 @@ export declare class DataNamespace extends DataNamespaceParent {
      * @returns A list of entities. An `undefined` is put at the index where an entity cannot be found
      */
     findAssociatedEntities(targets: AssociationTarget[]): (DataEntity | undefined)[];
+    /**
+     * Finds an associated entity in the current or foreign namespace.
+     * This is a helper function to discover entities in the current and foreign namespaces.
+     *
+     * @param key The key of the entity to find.
+     * @param namespace The optional namespace to search in.
+     * If not set, the current namespace is used.
+     * This is used to find entities in foreign namespaces.
+     * @returns The entity or undefined if not found.
+     */
+    findAssociatedEntity(key: string, namespace?: string): DataEntity | undefined;
     addForeign(ns: DataNamespace): void;
     removeForeign(ns: DataNamespace): void;
     hasForeignNamespace(key: string): boolean;

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

@@ -1 +1 @@
-{"version":3,"file":"DataNamespace.d.ts","sourceRoot":"","sources":["../../../src/modeling/DataNamespace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DataNamespace.d.ts","sourceRoot":"","sources":["../../../src/modeling/DataNamespace.ts"],"names":[],"mappings":"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"}

package/build/src/modeling/DataNamespace.js

@@ -329,6 +329,13 @@ export class DataNamespace extends DataNamespaceParent {
         }
         return result;
     }
+    /**
+     * Checks if this is the root namespace.
+     * @returns True if this is the root namespace.
+     */
+    isRoot() {
+        return this.root === undefined;
+    }
     /**
      * Finds a parent namespace for the given namespace.
      * @param key The namespace key to find the parent for.
@@ -382,6 +389,55 @@ export class DataNamespace extends DataNamespaceParent {
         root.items.push(item);
         return definition;
     }
+    /**
+     * Adapts an existing namespace to this namespace.
+     * This will remove the namespace from the parent namespace and add it to this one.
+     *
+     * @param ns The namespace to adapt.
+     * @param opts Adapting options.
+     */
+    adaptNamespace(ns, opts = {}) {
+        if (opts.index !== undefined) {
+            if (opts.index < 0) {
+                throw new Error(`The index ${opts.index} cannot be below 0.`);
+            }
+            if (opts.index >= this.items.length) {
+                throw new Error(`The index ${opts.index} is not valid.`);
+            }
+        }
+        if (ns === this) {
+            throw new Error(`Unable to adapt a namespace that is self.`);
+        }
+        if (ns.root !== this.root) {
+            throw new Error(`The namespace ${ns.key} is not in the same namespace as this data namespace.`);
+        }
+        if (ns.getParent() === this) {
+            throw new Error(`The namespace ${ns.key} is already adapted by this data namespace.`);
+        }
+        // Check for circular dependency
+        let current = this;
+        while (current) {
+            if (current === ns) {
+                throw new Error(`Unable to adapt namespace ${ns.key} under itself or one of its children.`);
+            }
+            current = current.getParent();
+        }
+        const parent = ns.getParent() || this.root;
+        if (!parent) {
+            throw new Error(`The namespace ${ns.key} has no parent.`);
+        }
+        const index = parent.items.findIndex((i) => i.key === ns.key);
+        if (index < 0) {
+            throw new Error(`The namespace ${ns.key} is not in the parent data namespace.`);
+        }
+        const [item] = parent.items.splice(index, 1);
+        if (opts.index !== undefined) {
+            this.items.splice(opts.index, 0, item);
+        }
+        else {
+            this.items.push(item);
+        }
+    }
     /**
      * Finds a namespace in the definitions.
      * @param key The key of the namespace to find.
@@ -597,6 +653,29 @@ export class DataNamespace extends DataNamespaceParent {
         });
         return result;
     }
+    /**
+     * Finds an associated entity in the current or foreign namespace.
+     * This is a helper function to discover entities in the current and foreign namespaces.
+     *
+     * @param key The key of the entity to find.
+     * @param namespace The optional namespace to search in.
+     * If not set, the current namespace is used.
+     * This is used to find entities in foreign namespaces.
+     * @returns The entity or undefined if not found.
+     */
+    findAssociatedEntity(key, namespace) {
+        let ns;
+        if (namespace) {
+            ns = this.foreign.find((i) => i.key === namespace);
+        }
+        else {
+            ns = this;
+        }
+        if (!ns) {
+            return undefined;
+        }
+        return ns.findEntity(key);
+    }
     addForeign(ns) {
         const exists = this.foreign.some((i) => i.key === ns.key);
         if (exists) {