@api-client/core 0.11.10 → 0.12.0

package/build/src/modeling/DomainAssociation.js

@@ -0,0 +1,440 @@
+import { __esDecorate, __runInitializers } from "tslib";
+import { DomainAssociationKind } from '../models/kinds.js';
+import { DomainElement } from './DomainElement.js';
+import { nanoid } from 'nanoid';
+import { Thing } from '../models/Thing.js';
+import { observed, retargetChange, toRaw } from './observed.js';
+import { Json } from '@api-client/json';
+import { DomainAttributeAttributes } from './DataFormat.js';
+import { ShapeGenerator } from './amf/ShapeGenerator.js';
+/**
+ * Represents an association between entities in a data domain.
+ *
+ * A `DomainAssociation` defines a relationship between a
+ * `DomainEntity` and one or more other entities. It specifies
+ * how entities are connected and can represent various types
+ * of relationships, such as one-to-one, one-to-many, or
+ * many-to-many.
+ *
+ * **Key Features:**
+ *
+ * -   **Target Entities:** Specifies the entities that are
+ *     the target of the association.
+ * -   **Cardinality:** Defines whether the association is
+ *     single-valued or multi-valued (e.g., one-to-one vs.
+ *     one-to-many).
+ * -   **Required Status:** Indicates whether the association
+ *     is mandatory or optional.
+ * -   **Schema Customization:** Allows defining a custom
+ *     schema for the association, overriding the default
+ *     schema derived from the target entities.
+ * -   **Bindings:** Supports defining how the association is
+ *     represented in different formats (e.g., web APIs,
+ *     protocol buffers).
+ * -   **Foreign Namespaces:** Can target entities in other
+ *     namespaces, enabling cross-namespace relationships.
+ *
+ * **Usage:**
+ *
+ * The preferred way to create a `DomainAssociation` is
+ * through the `DomainEntity.addAssociation()` method.
+ *
+ * **Example:**
+ *
+ * ```typescript
+ * const dataDomain = new DataDomain();
+ * const userModel = dataDomain.addModel({ key: 'userModel' });
+ * const userEntity = userModel.addEntity({ key: 'user' });
+ * const addressEntity = userModel.addEntity({ key: 'address' });
+ * // Add an association from User to Address
+ * const addressAssociation = userEntity.addAssociation();
+ * addressAssociation.addTarget(addressEntity);
+ * ```
+ */
+let DomainAssociation = (() => {
+    let _classSuper = DomainElement;
+    let _info_decorators;
+    let _info_initializers = [];
+    let _info_extraInitializers = [];
+    let _required_decorators;
+    let _required_initializers = [];
+    let _required_extraInitializers = [];
+    let _multiple_decorators;
+    let _multiple_initializers = [];
+    let _multiple_extraInitializers = [];
+    let _schema_decorators;
+    let _schema_initializers = [];
+    let _schema_extraInitializers = [];
+    let _bindings_decorators;
+    let _bindings_initializers = [];
+    let _bindings_extraInitializers = [];
+    let _targets_decorators;
+    let _targets_initializers = [];
+    let _targets_extraInitializers = [];
+    return class DomainAssociation extends _classSuper {
+        static {
+            const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(_classSuper[Symbol.metadata] ?? null) : void 0;
+            _info_decorators = [retargetChange()];
+            _required_decorators = [observed()];
+            _multiple_decorators = [observed()];
+            _schema_decorators = [observed({ deep: true })];
+            _bindings_decorators = [observed({ deep: true })];
+            _targets_decorators = [observed({ deep: true })];
+            __esDecorate(this, null, _info_decorators, { kind: "accessor", name: "info", static: false, private: false, access: { has: obj => "info" in obj, get: obj => obj.info, set: (obj, value) => { obj.info = value; } }, metadata: _metadata }, _info_initializers, _info_extraInitializers);
+            __esDecorate(this, null, _required_decorators, { kind: "accessor", name: "required", static: false, private: false, access: { has: obj => "required" in obj, get: obj => obj.required, set: (obj, value) => { obj.required = value; } }, metadata: _metadata }, _required_initializers, _required_extraInitializers);
+            __esDecorate(this, null, _multiple_decorators, { kind: "accessor", name: "multiple", static: false, private: false, access: { has: obj => "multiple" in obj, get: obj => obj.multiple, set: (obj, value) => { obj.multiple = value; } }, metadata: _metadata }, _multiple_initializers, _multiple_extraInitializers);
+            __esDecorate(this, null, _schema_decorators, { kind: "accessor", name: "schema", static: false, private: false, access: { has: obj => "schema" in obj, get: obj => obj.schema, set: (obj, value) => { obj.schema = value; } }, metadata: _metadata }, _schema_initializers, _schema_extraInitializers);
+            __esDecorate(this, null, _bindings_decorators, { kind: "accessor", name: "bindings", static: false, private: false, access: { has: obj => "bindings" in obj, get: obj => obj.bindings, set: (obj, value) => { obj.bindings = value; } }, metadata: _metadata }, _bindings_initializers, _bindings_extraInitializers);
+            __esDecorate(this, null, _targets_decorators, { kind: "accessor", name: "targets", static: false, private: false, access: { has: obj => "targets" in obj, get: obj => obj.targets, set: (obj, value) => { obj.targets = value; } }, metadata: _metadata }, _targets_initializers, _targets_extraInitializers);
+            if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
+        }
+        /**
+         * The kind of the domain element.
+         */
+        kind;
+        #info_accessor_storage = __runInitializers(this, _info_initializers, void 0);
+        /**
+         * The description of the association namespace.
+         */
+        get info() { return this.#info_accessor_storage; }
+        set info(value) { this.#info_accessor_storage = value; }
+        #required_accessor_storage = (__runInitializers(this, _info_extraInitializers), __runInitializers(this, _required_initializers, void 0));
+        /**
+         * Wether the data association is required.
+         */
+        get required() { return this.#required_accessor_storage; }
+        set required(value) { this.#required_accessor_storage = value; }
+        #multiple_accessor_storage = (__runInitializers(this, _required_extraInitializers), __runInitializers(this, _multiple_initializers, void 0));
+        /**
+         * Whether the data association allows multiple items.
+         */
+        get multiple() { return this.#multiple_accessor_storage; }
+        set multiple(value) { this.#multiple_accessor_storage = value; }
+        #schema_accessor_storage = (__runInitializers(this, _multiple_extraInitializers), __runInitializers(this, _schema_initializers, void 0));
+        /**
+         * The schema allowing to translate the model into a
+         * specific format (like JSON, RAML, XML, etc.)
+         */
+        get schema() { return this.#schema_accessor_storage; }
+        set schema(value) { this.#schema_accessor_storage = value; }
+        #bindings_accessor_storage = (__runInitializers(this, _schema_extraInitializers), __runInitializers(this, _bindings_initializers, void 0));
+        /**
+         * The list of bindings for this property.
+         *
+         * A binding defines a translation from a data model to a specific format.
+         * For example allows to define properties required to generate AMF shape and therefore RAML/OAS shapes for web APIs
+         * or a protocol buffer schema.
+         */
+        get bindings() { return this.#bindings_accessor_storage; }
+        set bindings(value) { this.#bindings_accessor_storage = value; }
+        /**
+         * The key of the parent entity.
+         */
+        parent = __runInitializers(this, _bindings_extraInitializers);
+        #targets_accessor_storage = __runInitializers(this, _targets_initializers, void 0);
+        /**
+         * The list of keys associated with the entity through this association.
+         * An association without a target is considered invalid and discarded when processing the values.
+         * When multiple associations are set then we are dealing with an union.
+         */
+        get targets() { return this.#targets_accessor_storage; }
+        set targets(value) { this.#targets_accessor_storage = value; }
+        /**
+         * Creates a full data association schema with defaults.
+         *
+         * @param input The partial data association schema.
+         * @returns The data association schema.
+         */
+        static createSchema(input = {}) {
+            const { key = nanoid() } = input;
+            const info = Thing.fromJSON(input.info, { name: 'New association' }).toJSON();
+            const result = {
+                kind: DomainAssociationKind,
+                key,
+                info,
+            };
+            if (input.schema) {
+                result.schema = structuredClone(input.schema);
+            }
+            if (typeof input.multiple === 'boolean') {
+                result.multiple = input.multiple;
+            }
+            if (typeof input.required === 'boolean') {
+                result.required = input.required;
+            }
+            if (Array.isArray(input.bindings)) {
+                result.bindings = input.bindings.map((i) => structuredClone(i));
+            }
+            if (Array.isArray(input.targets)) {
+                result.targets = input.targets.map((i) => ({ ...i }));
+            }
+            return result;
+        }
+        /**
+         * Creates a new data association instance.
+         *
+         * You probably want to use the `DomainEntity.addAssociation()` method instead.
+         *
+         * @param root A reference to the root DataDomain instance.
+         * @param parent The key of the parent entity.
+         * @param input The partial data association schema.
+         */
+        constructor(root, parent, input) {
+            const init = DomainAssociation.createSchema(input);
+            super(root, init.key);
+            __runInitializers(this, _targets_extraInitializers);
+            this.parent = parent;
+            this.kind = DomainAssociationKind;
+            this.info = new Thing(init.info);
+            if (init.schema) {
+                this.schema = structuredClone(init.schema);
+            }
+            if (typeof init.multiple === 'boolean') {
+                this.multiple = init.multiple;
+            }
+            if (typeof init.required === 'boolean') {
+                this.required = init.required;
+            }
+            if (Array.isArray(init.bindings)) {
+                this.bindings = init.bindings.map((i) => structuredClone(i));
+            }
+            else {
+                this.bindings = [];
+            }
+            if (Array.isArray(init.targets)) {
+                this.targets = init.targets.map((i) => ({ ...i }));
+            }
+            else {
+                this.targets = [];
+            }
+        }
+        /**
+         * Generates a JSON representation of the association.
+         *
+         * @returns A plain object representation of the `DomainAssociation`.
+         */
+        toJSON() {
+            const result = {
+                kind: this.kind,
+                key: this.key,
+                info: this.info.toJSON(),
+            };
+            if (this.schema) {
+                result.schema = Json.clone(toRaw(this, this.schema));
+            }
+            if (typeof this.multiple === 'boolean') {
+                result.multiple = this.multiple;
+            }
+            if (typeof this.required === 'boolean') {
+                result.required = this.required;
+            }
+            if (Array.isArray(this.bindings) && this.bindings.length) {
+                result.bindings = toRaw(this, this.bindings).map((i) => Json.clone(i));
+            }
+            if (Array.isArray(this.targets) && this.targets.length) {
+                result.targets = toRaw(this, this.targets).map((i) => ({ ...i }));
+            }
+            return result;
+        }
+        /**
+         * Returns a parent data entity where this data property exist.
+         *
+         * @returns The parent `DomainEntity` or undefined if not found.
+         */
+        getParentInstance() {
+            return this.root.graph.node(this.parent);
+        }
+        /**
+         * Removes this property from the parent entity.
+         *
+         * This method removes the association from the parent
+         * entity's list of associations.
+         *
+         * @example
+         * ```typescript
+         * association.remove();
+         * ```
+         */
+        remove() {
+            const parent = this.getParentInstance();
+            parent?.removeAssociation(this.key);
+        }
+        /**
+         * Creates the `schema` object if missing and returns it.
+         *
+         * @returns The schema object.
+         * @example
+         * ```typescript
+         * const schema = association.ensureSchema();
+         * ```
+         */
+        ensureSchema() {
+            if (!this.schema) {
+                this.schema = {};
+            }
+            return this.schema;
+        }
+        /**
+         * Checks whether the passed value is one of the supported
+         * data property attributes.
+         *
+         * @param value The value to test
+         * @returns True when the passed value is one of the
+         *   supported data property attributes.
+         */
+        static isValidAttribute(value) {
+            if (typeof value !== 'string') {
+                return false;
+            }
+            return DomainAttributeAttributes.includes(value);
+        }
+        /**
+         * Creates if not existing and returns web bindings
+         * definition.
+         *
+         * @returns The web binding definition
+         * @example
+         * ```typescript
+         * const webBindings = association.getWebBinding();
+         * webBindings.hidden = true;
+         * ```
+         */
+        getWebBinding() {
+            let object = this.bindings.find((i) => i.type === 'web');
+            if (!object) {
+                object = { type: 'web', schema: {} };
+                this.bindings.push(object);
+                this.domain.notifyChange();
+            }
+            return object.schema;
+        }
+        /**
+         * Returns the schema value of the binding, if any was
+         * created.
+         *
+         * @param type The type of the binding to read.
+         * @returns The binding schema, if any
+         * @example
+         * ```typescript
+         * const webBindings = association.readBinding('web');
+         * if (webBindings) {
+         *   // ...
+         * }
+         * ```
+         */
+        readBinding(type) {
+            const item = this.bindings.find((i) => i.type === type);
+            return item?.schema || undefined;
+        }
+        /**
+         * Adds a target entity to the association.
+         *
+         * @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;
+            if (typeof init === 'string') {
+                key = init;
+            }
+            else {
+                key = init.key;
+                if (init.domain.key !== this.root.key) {
+                    namespace = init.domain.key;
+                }
+            }
+            if (this.targets.some((i) => i.key === key && i.domain === namespace)) {
+                const message = `Target ${key} already exists.`;
+                throw new Error(message);
+            }
+            if (namespace && !this.root.dependencies.has(namespace)) {
+                throw new Error(`Foreign namespace "${namespace}" does not exist.`);
+            }
+            const info = {
+                key,
+            };
+            if (namespace) {
+                info.domain = namespace;
+            }
+            this.targets.push(info);
+            const targetKey = namespace ? `${namespace}:${key}` : key;
+            const label = {
+                type: 'association',
+            };
+            if (namespace) {
+                label.domain = namespace;
+                label.foreign = true;
+            }
+            // We need to associate the target with the association
+            // in the graph. This way, when looking for associations
+            // on a target entities we can easily locate the
+            // association.
+            this.root.graph.setEdge(this.key, targetKey, label);
+            // this.root.notifyChange()
+        }
+        /**
+         * Removes a target entity from the targets list.
+         *
+         * @param init The key of an entity, its instance, or
+         *   schema.
+         * @example
+         * ```typescript
+         * association.removeTarget(addressEntity);
+         * ```
+         */
+        removeTarget(init) {
+            let key;
+            if (typeof init === 'string') {
+                key = init;
+            }
+            else {
+                key = init.key;
+            }
+            const index = this.targets.findIndex((i) => i.key === key);
+            if (index >= 0) {
+                this.targets.splice(index, 1);
+                // this.root.notifyChange()
+            }
+            this.root.graph.removeEdge(this.key, key);
+        }
+        /**
+         * Lists all target entities of this association.
+         *
+         * @returns A generator that yields each target
+         *   `DomainEntity`.
+         * @example
+         * ```typescript
+         * for (const target of association.listTargets()) {
+         *   console.log(target.key);
+         * }
+         * ```
+         */
+        *listTargets() {
+            for (const target of this.targets) {
+                const { key, domain } = target;
+                const targetKey = domain ? `${domain}:${key}` : key;
+                const entity = this.root.graph.node(targetKey);
+                if (entity) {
+                    yield entity;
+                }
+            }
+        }
+        /**
+         * Creates a Property Shape of AMF.
+         * The property itself is auto-generated. If the `schema` is defined then it is used
+         * as the `range` of the property. Otherwise basic shape is generated for the range.
+         *
+         * This is a preferred way of reading the AMF shape as this synchronizes changed
+         * data properties with the shape definition.
+         *
+         * @returns AMF property shape definition.
+         */
+        toApiShape() {
+            const serializer = new ShapeGenerator();
+            return serializer.associationProperty(this);
+        }
+    };
+})();
+export { DomainAssociation };
+//# sourceMappingURL=DomainAssociation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DomainAssociation.js","sourceRoot":"","sources":["../../../src/modeling/DomainAssociation.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DataDomain } from './DataDomain.js'\nimport { DomainAssociationKind } from '../models/kinds.js'\nimport { DomainElement, type DomainElementSchema } from './DomainElement.js'\nimport { nanoid } from 'nanoid'\nimport { type IThing, Thing } from '../models/Thing.js'\nimport { observed, retargetChange, toRaw } from './observed.js'\nimport type { DomainEntity } from './DomainEntity.js'\nimport type { IApiAssociationShape, IApiPropertyShape } from '../amf/definitions/Shapes.js'\nimport type { AssociationBinding, AssociationBindings, AssociationWebBindings } from './Bindings.js'\nimport { Json } from '@api-client/json'\nimport { DomainAttributeAttribute, DomainAttributeAttributes } from './DataFormat.js'\nimport type { AssociationTarget, DomainGraphEdge } from './types.js'\nimport { ShapeGenerator } from './amf/ShapeGenerator.js'\n\nexport interface DomainAssociationSchema extends DomainElementSchema {\n  kind: typeof DomainAssociationKind\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 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   * 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/**\n * Represents an association between entities in a data domain.\n *\n * A `DomainAssociation` defines a relationship between a\n * `DomainEntity` and one or more other entities. It specifies\n * how entities are connected and can represent various types\n * of relationships, such as one-to-one, one-to-many, or\n * many-to-many.\n *\n * **Key Features:**\n *\n * -   **Target Entities:** Specifies the entities that are\n *     the target of the association.\n * -   **Cardinality:** Defines whether the association is\n *     single-valued or multi-valued (e.g., one-to-one vs.\n *     one-to-many).\n * -   **Required Status:** Indicates whether the association\n *     is mandatory or optional.\n * -   **Schema Customization:** Allows defining a custom\n *     schema for the association, overriding the default\n *     schema derived from the target entities.\n * -   **Bindings:** Supports defining how the association is\n *     represented in different formats (e.g., web APIs,\n *     protocol buffers).\n * -   **Foreign Namespaces:** Can target entities in other\n *     namespaces, enabling cross-namespace relationships.\n *\n * **Usage:**\n *\n * The preferred way to create a `DomainAssociation` is\n * through the `DomainEntity.addAssociation()` 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 * const addressEntity = userModel.addEntity({ key: 'address' });\n * // Add an association from User to Address\n * const addressAssociation = userEntity.addAssociation();\n * addressAssociation.addTarget(addressEntity);\n * ```\n */\nexport class DomainAssociation extends DomainElement {\n  /**\n   * The kind of the domain element.\n   */\n  override kind: typeof DomainAssociationKind\n\n  /**\n   * The description of the association namespace.\n   */\n  @retargetChange() accessor info: Thing\n\n  /**\n   * Wether the data association is required.\n   */\n  @observed() accessor required: boolean | undefined\n\n  /**\n   * Whether the data association allows multiple items.\n   */\n  @observed() accessor multiple: boolean | undefined\n\n  /**\n   * The schema allowing to translate the model into a\n   * specific format (like JSON, RAML, XML, etc.)\n   */\n  @observed({ deep: true }) accessor schema: IApiAssociationShape | undefined\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  @observed({ deep: true }) accessor bindings: AssociationBinding[]\n\n  /**\n   * The key of the parent entity.\n   */\n  protected parent: string\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  @observed({ deep: true }) accessor targets: AssociationTarget[]\n\n  /**\n   * Creates a full data association schema with defaults.\n   *\n   * @param input The partial data association schema.\n   * @returns The data association schema.\n   */\n  static createSchema(input: Partial<DomainAssociationSchema> = {}): DomainAssociationSchema {\n    const { key = nanoid() } = input\n    const info = Thing.fromJSON(input.info, { name: 'New association' }).toJSON()\n    const result: DomainAssociationSchema = {\n      kind: DomainAssociationKind,\n      key,\n      info,\n    }\n    if (input.schema) {\n      result.schema = structuredClone(input.schema)\n    }\n    if (typeof input.multiple === 'boolean') {\n      result.multiple = input.multiple\n    }\n    if (typeof input.required === 'boolean') {\n      result.required = input.required\n    }\n    if (Array.isArray(input.bindings)) {\n      result.bindings = input.bindings.map((i) => structuredClone(i))\n    }\n    if (Array.isArray(input.targets)) {\n      result.targets = input.targets.map((i) => ({ ...i }))\n    }\n    return result\n  }\n\n  /**\n   * Creates a new data association instance.\n   *\n   * You probably want to use the `DomainEntity.addAssociation()` method instead.\n   *\n   * @param root A reference to the root DataDomain instance.\n   * @param parent The key of the parent entity.\n   * @param input The partial data association schema.\n   */\n  constructor(root: DataDomain, parent: string, input?: Partial<DomainAssociationSchema>) {\n    const init = DomainAssociation.createSchema(input)\n    super(root, init.key)\n    this.parent = parent\n    this.kind = DomainAssociationKind\n    this.info = new Thing(init.info)\n    if (init.schema) {\n      this.schema = structuredClone(init.schema)\n    }\n    if (typeof init.multiple === 'boolean') {\n      this.multiple = init.multiple\n    }\n    if (typeof init.required === 'boolean') {\n      this.required = init.required\n    }\n    if (Array.isArray(init.bindings)) {\n      this.bindings = init.bindings.map((i) => structuredClone(i))\n    } else {\n      this.bindings = []\n    }\n    if (Array.isArray(init.targets)) {\n      this.targets = init.targets.map((i) => ({ ...i }))\n    } else {\n      this.targets = []\n    }\n  }\n\n  /**\n   * Generates a JSON representation of the association.\n   *\n   * @returns A plain object representation of the `DomainAssociation`.\n   */\n  toJSON(): DomainAssociationSchema {\n    const result: DomainAssociationSchema = {\n      kind: this.kind,\n      key: this.key,\n      info: this.info.toJSON(),\n    }\n    if (this.schema) {\n      result.schema = Json.clone(toRaw(this, 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.bindings) && this.bindings.length) {\n      result.bindings = (toRaw(this, this.bindings) as AssociationBinding[]).map((i) => Json.clone(i))\n    }\n    if (Array.isArray(this.targets) && this.targets.length) {\n      result.targets = (toRaw(this, this.targets) as AssociationTarget[]).map((i) => ({ ...i }))\n    }\n    return result\n  }\n\n  /**\n   * Returns a parent data entity where this data property exist.\n   *\n   * @returns The parent `DomainEntity` or undefined if not found.\n   */\n  getParentInstance(): DomainEntity | undefined {\n    return this.root.graph.node(this.parent) as DomainEntity | undefined\n  }\n\n  /**\n   * Removes this property from the parent entity.\n   *\n   * This method removes the association from the parent\n   * entity's list of associations.\n   *\n   * @example\n   * ```typescript\n   * association.remove();\n   * ```\n   */\n  remove(): void {\n    const parent = this.getParentInstance()\n    parent?.removeAssociation(this.key)\n  }\n\n  /**\n   * Creates the `schema` object if missing and returns it.\n   *\n   * @returns The schema object.\n   * @example\n   * ```typescript\n   * const schema = association.ensureSchema();\n   * ```\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\n   * data property attributes.\n   *\n   * @param value The value to test\n   * @returns True when the passed value is one of the\n   *   supported data property attributes.\n   */\n  static isValidAttribute(value: unknown): value is DomainAttributeAttribute {\n    if (typeof value !== 'string') {\n      return false\n    }\n    return DomainAttributeAttributes.includes(value as DomainAttributeAttribute)\n  }\n\n  /**\n   * Creates if not existing and returns web bindings\n   * definition.\n   *\n   * @returns The web binding definition\n   * @example\n   * ```typescript\n   * const webBindings = association.getWebBinding();\n   * webBindings.hidden = true;\n   * ```\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      this.domain.notifyChange()\n    }\n    return object.schema as AssociationWebBindings\n  }\n\n  /**\n   * Returns the schema value of the binding, if any was\n   * created.\n   *\n   * @param type The type of the binding to read.\n   * @returns The binding schema, if any\n   * @example\n   * ```typescript\n   * const webBindings = association.readBinding('web');\n   * if (webBindings) {\n   *   // ...\n   * }\n   * ```\n   */\n  readBinding(type: 'web' | 'protobuf'): AssociationBindings | undefined {\n    const item = this.bindings.find((i) => i.type === type) as AssociationBinding\n    return item?.schema || undefined\n  }\n\n  /**\n   * Adds a target entity to the association.\n   *\n   * If the entity comes from another namespace then it is\n   * set as a foreign entity.\n   *\n   * @param entity - The `DomainEntity` instance to add.\n   * @example\n   * ```typescript\n   * association.addTarget(addressEntity);\n   * ```\n   */\n  addTarget(entity: DomainEntity): void\n\n  /**\n   * Adds a target entity to the association.\n   *\n   * @param entity - The `DomainEntity` definition or just\n   *   its key.\n   * @param namespace - The key of the foreign namespace this\n   *   entity belongs to. Do not set this value for local\n   *   entities.\n   * @example\n   * ```typescript\n   * association.addTarget('address', 'foreignNamespace');\n   * ```\n   */\n  addTarget(entity: string, namespace?: string): void\n\n  /**\n   * Adds a target entity to the association.\n   *\n   * @param init The key of an entity, its instance, or schema.\n   * @param namespace - The key of the foreign namespace this\n   *   entity belongs to. Do not set this value for local entities.\n   */\n  addTarget(init: string | DomainEntity, namespace?: string): void {\n    let key: string\n    if (typeof init === 'string') {\n      key = init\n    } else {\n      key = init.key\n      if (init.domain.key !== this.root.key) {\n        namespace = init.domain.key\n      }\n    }\n    if (this.targets.some((i) => i.key === key && i.domain === namespace)) {\n      const message = `Target ${key} already exists.`\n      throw new Error(message)\n    }\n    if (namespace && !this.root.dependencies.has(namespace)) {\n      throw new Error(`Foreign namespace \"${namespace}\" does not exist.`)\n    }\n    const info: AssociationTarget = {\n      key,\n    }\n    if (namespace) {\n      info.domain = namespace\n    }\n    this.targets.push(info)\n    const targetKey = namespace ? `${namespace}:${key}` : key\n    const label: DomainGraphEdge = {\n      type: 'association',\n    }\n    if (namespace) {\n      label.domain = namespace\n      label.foreign = true\n    }\n    // We need to associate the target with the association\n    // in the graph. This way, when looking for associations\n    // on a target entities we can easily locate the\n    // association.\n    this.root.graph.setEdge(this.key, targetKey, label)\n    // this.root.notifyChange()\n  }\n\n  /**\n   * Removes a target entity from the targets list.\n   *\n   * @param init The key of an entity, its instance, or\n   *   schema.\n   * @example\n   * ```typescript\n   * association.removeTarget(addressEntity);\n   * ```\n   */\n  removeTarget(init: string | DomainEntity): 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      // this.root.notifyChange()\n    }\n    this.root.graph.removeEdge(this.key, key)\n  }\n\n  /**\n   * Lists all target entities of this association.\n   *\n   * @returns A generator that yields each target\n   *   `DomainEntity`.\n   * @example\n   * ```typescript\n   * for (const target of association.listTargets()) {\n   *   console.log(target.key);\n   * }\n   * ```\n   */\n  *listTargets(): Generator<DomainEntity> {\n    for (const target of this.targets) {\n      const { key, domain } = target\n      const targetKey = domain ? `${domain}:${key}` : key\n      const entity = this.root.graph.node(targetKey) as DomainEntity | undefined\n      if (entity) {\n        yield entity\n      }\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 ShapeGenerator()\n    return serializer.associationProperty(this)\n  }\n}\n"]}

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

@@ -0,0 +1,33 @@
+import type { DataDomain } from './DataDomain.js';
+export interface DomainElementSchema {
+    /**
+     * The kind of the domain element.
+     */
+    kind: string;
+    /**
+     * The unique key of the domain element.
+     */
+    key: string;
+}
+export declare abstract class DomainElement implements DomainElementSchema {
+    #private;
+    /**
+     * A reference to the root DataDomain instance.
+     */
+    protected root: DataDomain;
+    /**
+     * The root DataDomain instance.
+     */
+    get domain(): DataDomain;
+    abstract accessor kind: string;
+    /**
+     * The unique key of the domain element.
+     */
+    get key(): string;
+    /**
+     * @param root The root DataDomain instance.
+     * @param key The unique key of the domain element.
+     */
+    constructor(root: DataDomain, key: string);
+}
+//# sourceMappingURL=DomainElement.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DomainElement.d.ts","sourceRoot":"","sources":["../../../src/modeling/DomainElement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,8BAAsB,aAAc,YAAW,mBAAmB;;IAChE;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,CAAA;IAE1B;;OAEG;IACH,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAQ9B;;OAEG;IACH,IAAI,GAAG,IAAI,MAAM,CAEhB;IAED;;;OAGG;gBACS,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM;CAI1C"}

package/build/src/modeling/DomainElement.js

@@ -0,0 +1,32 @@
+export class DomainElement {
+    /**
+     * A reference to the root DataDomain instance.
+     */
+    root;
+    /**
+     * The root DataDomain instance.
+     */
+    get domain() {
+        return this.root;
+    }
+    /**
+     * The unique key of the domain element.
+     * Since keys are immutable, we use a private field to store the key.
+     */
+    #key;
+    /**
+     * The unique key of the domain element.
+     */
+    get key() {
+        return this.#key;
+    }
+    /**
+     * @param root The root DataDomain instance.
+     * @param key The unique key of the domain element.
+     */
+    constructor(root, key) {
+        this.root = root;
+        this.#key = key;
+    }
+}
+//# sourceMappingURL=DomainElement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DomainElement.js","sourceRoot":"","sources":["../../../src/modeling/DomainElement.ts"],"names":[],"mappings":"AAaA,MAAM,OAAgB,aAAa;IACjC;;OAEG;IACO,IAAI,CAAY;IAE1B;;OAEG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAID;;;OAGG;IACH,IAAI,CAAQ;IAEZ;;OAEG;IACH,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAA;IAClB,CAAC;IAED;;;OAGG;IACH,YAAY,IAAgB,EAAE,GAAW;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAA;IACjB,CAAC;CACF","sourcesContent":["import type { DataDomain } from './DataDomain.js'\n\nexport interface DomainElementSchema {\n  /**\n   * The kind of the domain element.\n   */\n  kind: string\n  /**\n   * The unique key of the domain element.\n   */\n  key: string\n}\n\nexport abstract class DomainElement implements DomainElementSchema {\n  /**\n   * A reference to the root DataDomain instance.\n   */\n  protected root: DataDomain\n\n  /**\n   * The root DataDomain instance.\n   */\n  get domain(): DataDomain {\n    return this.root\n  }\n\n  abstract accessor kind: string\n\n  /**\n   * The unique key of the domain element.\n   * Since keys are immutable, we use a private field to store the key.\n   */\n  #key: string\n\n  /**\n   * The unique key of the domain element.\n   */\n  get key(): string {\n    return this.#key\n  }\n\n  /**\n   * @param root The root DataDomain instance.\n   * @param key The unique key of the domain element.\n   */\n  constructor(root: DataDomain, key: string) {\n    this.root = root\n    this.#key = key\n  }\n}\n"]}