@api-client/core 0.14.6 → 0.14.8

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

@@ -1,18 +1,18 @@
 import { Graph } from '@api-client/graph/graph/Graph.js';
 import { DataDomainKind } from '../models/kinds.js';
-import type { AssociationAddOptions, DomainGraphEdge, DomainGraphNodeType, ForeignDomainDependency, SerializedGraph } from './types.js';
+import type { AssociationAddOptions, DomainGraphEdge, DomainGraphNodeType, SerializedGraph } from './types.js';
 import { type DomainNamespaceSchema, DomainNamespace, type NamespaceOrderedItem } from './DomainNamespace.js';
 import { type DomainModelSchema, DomainModel } from './DomainModel.js';
 import { type DomainEntitySchema, DomainEntity } from './DomainEntity.js';
 import { DomainAssociation } from './DomainAssociation.js';
 import { DomainProperty, DomainPropertySchema } from './DomainProperty.js';
 import { type IThing, Thing } from '../models/Thing.js';
-export interface DataDomainSchema {
+import { DependentModel, type DependentModelSchema, type DomainDependency } from './DependentModel.js';
+export interface DataDomainSchema extends DependentModelSchema {
     info: IThing;
     kind: typeof DataDomainKind;
     key: string;
     graph?: SerializedGraph;
-    dependencyList?: ForeignDomainDependency[];
     /**
      * The ordered list of fields (namespace and models) in the schema.
      * These only keep references to define the order of these properties
@@ -86,7 +86,7 @@ export interface DataDomainSchema {
  * @todo: Implement a mechanism to move an entity to a new
  * parent model.
  */
-export declare class DataDomain extends EventTarget {
+export declare class DataDomain extends DependentModel {
     #private;
     /**
      * The kind of the domain element.
@@ -100,16 +100,6 @@ export declare class DataDomain extends EventTarget {
      * The graph used to store the data domain structure.
      */
     graph: Graph<unknown, DomainGraphNodeType, DomainGraphEdge>;
-    /**
-     * A map of foreign data domains.
-     * Key: The unique identifier of the foreign domain.
-     * Value: The foreign DataDomain instance.
-     */
-    dependencies: Map<string, DataDomain>;
-    /**
-     * The list of foreign domain dependencies.
-     */
-    dependencyList: ForeignDomainDependency[];
     /**
      * The description of the domain property.
      */
@@ -137,7 +127,7 @@ export declare class DataDomain extends EventTarget {
      * @param state The previously serialized state of the graph.
      * @param dependencies An array of foreign data domains to register with this domain.
      */
-    constructor(state?: Partial<DataDomainSchema>, dependencies?: DataDomain[]);
+    constructor(state?: Partial<DataDomainSchema>, dependencies?: DomainDependency[]);
     /**
      * Serializes the DataDomain instance to a JSON object.
      * It does not serialize the foreign domain dependencies. The serialized nodes
@@ -247,10 +237,28 @@ export declare class DataDomain extends EventTarget {
      * ```
      */
     listGraphNamespaces(parent?: string): Generator<DomainNamespace>;
+    /**
+     * Builds a reference key for a domain object.
+     *
+     * If the namespace is provided and it is different from the domain key,
+     * it will return the key in the format `namespace:key`. The foreign namespace
+     * must be registered in the domain's dependencies otherwise an error will be thrown.
+     *
+     * @param key The key of the namespace or model.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign namespace.
+     * @returns The reference key in the format `namespace:key` or just `key` if no namespace is provided.
+     * @throws Error When the foreign domain is not found.
+     * @example
+     * ```typescript
+     * const refKey = dataDomain.buildReferenceKey('userModel', 'domainKey');
+     * ```
+     */
+    buildReferenceKey(key: string, namespace?: string): string;
     /**
      * Finds a namespace by its key.
      *
      * @param key The key of the namespace to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign namespace.
      * @returns The namespace instance or undefined if not
      *   found.
      * @example
@@ -261,7 +269,7 @@ export declare class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findNamespace(key: string): DomainNamespace | undefined;
+    findNamespace(key: string, namespace?: string): DomainNamespace | undefined;
     /**
      * Moves a namespace to a new parent.
      *
@@ -360,6 +368,7 @@ export declare class DataDomain extends EventTarget {
      * Finds a data model by its key.
      *
      * @param key The key of the data model to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign entity.
      * @returns The data model instance or undefined if not
      *   found.
      * @example
@@ -370,7 +379,7 @@ export declare class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findModel(key: string): DomainModel | undefined;
+    findModel(key: string, namespace?: string): DomainModel | undefined;
     /**
      * Moves a data model to a new parent.
      *
@@ -436,6 +445,7 @@ export declare class DataDomain extends EventTarget {
      * Finds an entity by its key.
      *
      * @param key The key of the entity to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign entity.
      * @returns The entity instance or undefined if not found.
      * @example
      * ```typescript
@@ -445,7 +455,7 @@ export declare class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findEntity(key: string): DomainEntity | undefined;
+    findEntity(key: string, namespace?: string): DomainEntity | undefined;
     /**
      * Moves an entity from one model to another.
      *
@@ -493,6 +503,7 @@ export declare class DataDomain extends EventTarget {
      * Finds an association by its key.
      *
      * @param key The key of the association to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign association
      * @returns The association instance or undefined if not
      *   found.
      * @example
@@ -503,7 +514,7 @@ export declare class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findAssociation(key: string): DomainAssociation | undefined;
+    findAssociation(key: string, namespace?: string): DomainAssociation | undefined;
     /**
      * Adds a property to an entity.
      *
@@ -537,6 +548,7 @@ export declare class DataDomain extends EventTarget {
      * Finds a property by its key.
      *
      * @param key The key of the property to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign property
      * @returns The property instance or undefined if not
      *   found.
      * @example
@@ -547,7 +559,7 @@ export declare class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findProperty(key: string): DomainProperty | undefined;
+    findProperty(key: string, namespace?: string): DomainProperty | undefined;
     /**
      * Registers a foreign DataDomain.
      *
@@ -586,6 +598,8 @@ export declare class DataDomain extends EventTarget {
      *   console.log(foreignUser.key);
      * }
      * ```
+     * @deprecated Use `findEntity` with the `namespace` parameter instead.
+     * This method is kept for backward compatibility but will be removed in the future.
      */
     findForeignEntity(entityKey: string, domainKey: string): DomainEntity | undefined;
     /**

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

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

package/build/src/modeling/DataDomain.js

@@ -5,6 +5,7 @@ import { DomainModel } from './DomainModel.js';
 import { Thing } from '../models/Thing.js';
 import { removeGraphNode } from './GraphUtils.js';
 import { serialize, deserialize, mergeGraph, removeForeignGraph } from './DomainSerialization.js';
+import { DependentModel } from './DependentModel.js';
 /**
  * Represents the root of a data domain model.
  *
@@ -71,7 +72,7 @@ import { serialize, deserialize, mergeGraph, removeForeignGraph } from './Domain
  * @todo: Implement a mechanism to move an entity to a new
  * parent model.
  */
-export class DataDomain extends EventTarget {
+export class DataDomain extends DependentModel {
     /**
      * The kind of the domain element.
      */
@@ -84,16 +85,6 @@ export class DataDomain extends EventTarget {
      * The graph used to store the data domain structure.
      */
     graph;
-    /**
-     * A map of foreign data domains.
-     * Key: The unique identifier of the foreign domain.
-     * Value: The foreign DataDomain instance.
-     */
-    dependencies = new Map();
-    /**
-     * The list of foreign domain dependencies.
-     */
-    dependencyList = [];
     /**
      * The description of the domain property.
      */
@@ -155,13 +146,26 @@ export class DataDomain extends EventTarget {
      * @param state The previously serialized state of the graph.
      * @param dependencies An array of foreign data domains to register with this domain.
      */
-    constructor(state, dependencies) {
-        super();
+    constructor(state, dependencies = []) {
         const init = DataDomain.createSchema(state);
+        const instances = [];
+        for (const dep of dependencies) {
+            if (dep instanceof DataDomain) {
+                instances.push(dep);
+            }
+            else if (typeof dep === 'object' && dep.kind === DataDomainKind && dep.key) {
+                const domain = new DataDomain(dep);
+                instances.push(domain);
+            }
+            else {
+                throw new Error(`Invalid foreign domain dependency: ${dep}`);
+            }
+        }
+        super(init.dependencyList, instances);
         this.kind = init.kind;
         this.key = init.key;
         this.info = new Thing(init.info);
-        this.graph = deserialize(this, init.graph, dependencies);
+        this.graph = deserialize(this, init.graph, instances);
         if (Array.isArray(init.fields)) {
             this.fields = [...init.fields];
         }
@@ -389,10 +393,40 @@ export class DataDomain extends EventTarget {
             }
         }
     }
+    /**
+     * Builds a reference key for a domain object.
+     *
+     * If the namespace is provided and it is different from the domain key,
+     * it will return the key in the format `namespace:key`. The foreign namespace
+     * must be registered in the domain's dependencies otherwise an error will be thrown.
+     *
+     * @param key The key of the namespace or model.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign namespace.
+     * @returns The reference key in the format `namespace:key` or just `key` if no namespace is provided.
+     * @throws Error When the foreign domain is not found.
+     * @example
+     * ```typescript
+     * const refKey = dataDomain.buildReferenceKey('userModel', 'domainKey');
+     * ```
+     */
+    buildReferenceKey(key, namespace) {
+        if (namespace && namespace !== this.key) {
+            if (typeof namespace !== 'string' || namespace.length === 0) {
+                throw new Error(`Invalid namespace key. Expected a string, got ${typeof namespace}`);
+            }
+            const foreignDomain = this.dependencies.get(namespace);
+            if (!foreignDomain) {
+                throw new Error(`Foreign domain ${namespace} not found`);
+            }
+            return `${namespace}:${key}`;
+        }
+        return key;
+    }
     /**
      * Finds a namespace by its key.
      *
      * @param key The key of the namespace to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign namespace.
      * @returns The namespace instance or undefined if not
      *   found.
      * @example
@@ -403,8 +437,8 @@ export class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findNamespace(key) {
-        const result = this.graph.node(key);
+    findNamespace(key, namespace) {
+        const result = this.graph.node(this.buildReferenceKey(key, namespace));
         if (result && result.kind === DomainNamespaceKind) {
             return result;
         }
@@ -637,6 +671,7 @@ export class DataDomain extends EventTarget {
      * Finds a data model by its key.
      *
      * @param key The key of the data model to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign entity.
      * @returns The data model instance or undefined if not
      *   found.
      * @example
@@ -647,8 +682,8 @@ export class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findModel(key) {
-        const value = this.graph.node(key);
+    findModel(key, namespace) {
+        const value = this.graph.node(this.buildReferenceKey(key, namespace));
         if (value && value.kind === DomainModelKind) {
             return value;
         }
@@ -815,6 +850,7 @@ export class DataDomain extends EventTarget {
      * Finds an entity by its key.
      *
      * @param key The key of the entity to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign entity.
      * @returns The entity instance or undefined if not found.
      * @example
      * ```typescript
@@ -824,8 +860,8 @@ export class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findEntity(key) {
-        const node = this.graph.node(key);
+    findEntity(key, namespace) {
+        const node = this.graph.node(this.buildReferenceKey(key, namespace));
         if (node && node.kind === DomainEntityKind) {
             return node;
         }
@@ -936,6 +972,7 @@ export class DataDomain extends EventTarget {
      * Finds an association by its key.
      *
      * @param key The key of the association to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign association
      * @returns The association instance or undefined if not
      *   found.
      * @example
@@ -946,8 +983,8 @@ export class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findAssociation(key) {
-        const node = this.graph.node(key);
+    findAssociation(key, namespace) {
+        const node = this.graph.node(this.buildReferenceKey(key, namespace));
         if (node && node.kind === DomainAssociationKind) {
             return node;
         }
@@ -1018,6 +1055,7 @@ export class DataDomain extends EventTarget {
      * Finds a property by its key.
      *
      * @param key The key of the property to find.
+     * @param namespace The namespace to search in. When different from the domain key, it looks for a foreign property
      * @returns The property instance or undefined if not
      *   found.
      * @example
@@ -1028,8 +1066,8 @@ export class DataDomain extends EventTarget {
      * }
      * ```
      */
-    findProperty(key) {
-        const node = this.graph.node(key);
+    findProperty(key, namespace) {
+        const node = this.graph.node(this.buildReferenceKey(key, namespace));
         if (node && node.kind === DomainPropertyKind) {
             return node;
         }
@@ -1100,6 +1138,8 @@ export class DataDomain extends EventTarget {
      *   console.log(foreignUser.key);
      * }
      * ```
+     * @deprecated Use `findEntity` with the `namespace` parameter instead.
+     * This method is kept for backward compatibility but will be removed in the future.
      */
     findForeignEntity(entityKey, domainKey) {
         const foreignDomain = this.dependencies.get(domainKey);