@api-client/core 0.18.62 → 0.18.64

package/src/modeling/definitions/HTML.ts

@@ -3,34 +3,12 @@ import { SemanticType } from '../Semantics.js'
 
 /**
  * Configuration options for the HTML semantic.
- * Controls rendering, sanitization, and allowed HTML features.
  */
 export interface HTMLConfig {
   /**
    * List of allowed HTML tags in the content.
    */
   allowedTags?: string[]
-  /**
-   * Render mode: 'html', 'text', or 'both'.
-   *
-   * - `html` - The API returns the HTML content as-is (after sanitization based on your other rules like allowedTags).
-   * - `text` - The API returns the text content, stripping out all HTML tags.
-   *    This is extremely useful for various backend and frontend tasks:
-   *    - **Search Indexing**: You can easily feed the plain text content into a search engine like Elasticsearch
-   *      without the noise of HTML tags.
-   *    - **Content Previews/Summaries**: Displaying a snippet of the content in a list view or a notification
-   *      where formatting is not desired.
-   *    - **Compatibility**: Sending the content to systems that don't support HTML, such as plain-text
-   *      emails or SMS notifications.
-   * - `both` - The API returns an object containing both the raw HTML and the plain text version. For example:
-   *   ```json
-   *   {
-   *     "html": "<p>Hello, <strong>world</strong>!</p>",
-   *     "text": "Hello, world!"
-   *   }
-   *   ```
-   */
-  renderMode?: 'html' | 'text' | 'both'
   /**
    * Sanitization level: 'strict', 'moderate', or 'none'.
    */
@@ -119,7 +97,6 @@ export const createHTMLSemantic = (config: HTMLConfig = {}): AppliedHTMLSemantic
  */
 export const DEFAULT_HTML_CONFIG: HTMLConfig = {
   allowedTags: ['b', 'i', 'em', 'strong', 'a', 'ul', 'ol', 'li', 'p', 'br', 'pre', 'code', 'div', 'span'],
-  renderMode: 'html',
   sanitizeLevel: 'strict',
   allowImages: true,
   allowLinks: true,

package/src/modeling/definitions/Markdown.ts

@@ -10,22 +10,6 @@ export interface MarkdownConfig {
    * List of allowed HTML tags in the rendered output.
    */
   allowedTags?: string[]
-  /**
-   * Render mode: 'html', 'text', or 'both'.
-   * This controls how the stored Markdown content is transformed and returned by the API.
-   *
-   * - `html` - The API converts the Markdown to HTML and returns the sanitized result.
-   * - `text` - The original Markdown as when created, but sanitized.
-   * - `both` - The API returns an object containing both the rendered HTML and the plain text version.
-   *   This provides maximum flexibility for client applications.
-   *   ```json
-   *   {
-   *     "html": "<h1>Title</h1><p>Some <strong>bold</strong> text.</p>",
-   *     "text": "Title Some bold text."
-   *   }
-   *   ```
-   */
-  renderMode?: 'html' | 'text' | 'both'
   /**
    * Sanitization level: 'strict', 'moderate', or 'none'.
    */
@@ -110,7 +94,6 @@ export const createMarkdownSemantic = (config: MarkdownConfig = {}): AppliedMark
  */
 export const DEFAULT_MARKDOWN_CONFIG: MarkdownConfig = {
   allowedTags: ['b', 'i', 'em', 'strong', 'a', 'ul', 'ol', 'li', 'p', 'br', 'pre', 'code'],
-  renderMode: 'html',
   sanitizeLevel: 'strict',
   allowImages: true,
   allowLinks: true,

package/src/modeling/helpers/Intelisense.ts

@@ -325,13 +325,10 @@ export function addOwnerField(entity: DomainEntity, info: Partial<IThing> = {}):
   if (existing) {
     return existing
   }
-  const prop = entity.addAssociation(
-    {},
-    {
-      info: { name: 'owner', displayName: 'Owner', ...info },
-      required: true,
-    }
-  )
+  const prop = entity.addAssociation({
+    info: { name: 'owner', displayName: 'Owner', ...info },
+    required: true,
+  })
   prop.addSemantic({
     id: SemanticType.ResourceOwnerIdentifier,
   })
@@ -378,13 +375,10 @@ export function addUpdatedByField(entity: DomainEntity, info: Partial<IThing> =
   if (existing) {
     return existing
   }
-  const prop = entity.addAssociation(
-    {},
-    {
-      info: { name: 'updated_by', displayName: 'Updated By', ...info },
-      required: true,
-    }
-  )
+  const prop = entity.addAssociation({
+    info: { name: 'updated_by', displayName: 'Updated By', ...info },
+    required: true,
+  })
   prop.addSemantic({
     id: SemanticType.ResourceOwnerIdentifier,
   })

package/src/modeling/importers/JsonSchemaImporter.ts

@@ -455,7 +455,7 @@ export class JsonSchemaImporter {
     // Case 2: If any `$ref` was found, we treat it as an Association.
     if (analysis.refs.size > 0) {
       const sanitizedName = toDatabaseColumnName(propName, 'untitled_association')
-      const assoc = entity.addAssociation({}, { info: { name: sanitizedName } })
+      const assoc = entity.addAssociation({ info: { name: sanitizedName } })
       if (sanitizedName !== propName) {
         assoc.info.displayName = propName // Keep original name for display
       }

package/src/modeling/types.ts

@@ -33,21 +33,6 @@ export interface DataDomainRemoveOptions {
   force?: boolean
 }
 
-export interface AssociationAddOptions {
-  /**
-   * When set, it is the the association target's origin data domain.
-   * The key of the target data domain where this target entity is defined.
-   * Only used when `key` is specified.
-   */
-  domain?: string
-  /**
-   * The key of the association target, if known.
-   * If the target of the association is not specified, and the association has no other targets,
-   * the association is ignored in the namespace while processing.
-   */
-  key?: string
-}
-
 export interface DomainGraphEdge {
   /**
    * Indicates that the edge is to or from a foreign domain.

package/tests/unit/modeling/amf/shape_generator.spec.ts

@@ -95,7 +95,7 @@ test.group('entity()', (group) => {
 
   test('adds associations to the properties', ({ assert }) => {
     e1.addProperty({ key: 'test', info: { name: 'test' } })
-    e1.addAssociation({}, { info: { name: 'test association' } })
+    e1.addAssociation({ info: { name: 'test association' } })
     const result = e1.toApiShape() as IApiNodeShape
 
     assert.lengthOf(result.properties, 2)
@@ -777,7 +777,7 @@ test.group('associationProperty()', (group) => {
     m1 = root.addModel({ key: 'm1' })
     e1 = m1.addEntity({ key: 'e1', info: { name: 'e1' } })
     e2 = m1.addEntity({ key: 'e2', info: { name: 'e2' } })
-    a1 = e1.addAssociation({ key: e2.key }, { key: 'a1', info: { name: 'a1' } })
+    a1 = e1.addAssociation({ targets: [{ key: e2.key }], key: 'a1', info: { name: 'a1' } })
     e1.addProperty({ key: 'p1', type: 'boolean', info: { name: 'p1' } })
     p2 = e2.addProperty({ key: 'p2', type: 'number', info: { name: 'p2' } })
   })
@@ -1048,7 +1048,7 @@ test.group('AI Generated tests', (group) => {
     m1 = root.addModel({ key: 'm1' })
     e1 = m1.addEntity({ key: 'e1', info: { name: 'e1' } })
     e2 = m1.addEntity({ key: 'e2', info: { name: 'e2' } })
-    a1 = e1.addAssociation({ key: e2.key }, { key: 'a1', info: { name: 'a1' } })
+    a1 = e1.addAssociation({ targets: [{ key: e2.key }], key: 'a1', info: { name: 'a1' } })
     p1 = e1.addProperty({ key: 'p1', info: { name: 'p1' } })
   })
 
@@ -1067,7 +1067,7 @@ test.group('AI Generated tests', (group) => {
     const e3 = m2.addEntity({ key: 'e3', info: { name: 'e3' } })
     fd1.info.version = '1.0.0'
     root.registerForeignDomain(fd1)
-    const a2 = e1.addAssociation({ key: e3.key, domain: fd1.key }, { key: 'a2', info: { name: 'a2' } })
+    const a2 = e1.addAssociation({ targets: [{ key: e3.key, domain: fd1.key }], key: 'a2', info: { name: 'a2' } })
     const result = e1.toApiShape() as IApiNodeShape
     assert.lengthOf(result.properties, 3)
     assert.isTrue(result.properties.some((prop) => prop.id === a2.key))

package/tests/unit/modeling/api_model_expose_entity.spec.ts

@@ -72,7 +72,7 @@ test.group('ApiModel.exposeEntity()', () => {
     const eA = dm.addEntity({ info: { name: 'A' } })
     const eB = dm.addEntity({ info: { name: 'B' } })
     // Add association from A to B
-    eA.addAssociation({ key: eB.key }, { info: { name: 'entityB' } })
+    eA.addAssociation({ info: { name: 'entityB' }, targets: [{ key: eB.key }] })
     const model = new ApiModel()
     model.attachDataDomain(domain)
     const exposedA = model.exposeEntity({ key: eA.key }, { followAssociations: true })
@@ -90,8 +90,8 @@ test.group('ApiModel.exposeEntity()', () => {
     const eA = dm.addEntity({ info: { name: 'A' } })
     const eB = dm.addEntity({ info: { name: 'B' } })
     // A -> B, B -> A
-    eA.addAssociation({ key: eB.key }, { info: { name: 'assocAB' } })
-    eB.addAssociation({ key: eA.key }, { info: { name: 'assocBA' } })
+    eA.addAssociation({ info: { name: 'assocAB' }, targets: [{ key: eB.key }] })
+    eB.addAssociation({ info: { name: 'assocBA' }, targets: [{ key: eA.key }] })
     const model = new ApiModel()
     model.attachDataDomain(domain)
     model.exposeEntity({ key: eA.key }, { followAssociations: true, maxDepth: 4 })
@@ -114,7 +114,7 @@ test.group('ApiModel.exposeEntity()', () => {
     const dm = domain.addModel()
     const eA = dm.addEntity({ info: { name: 'A' } })
     // A -> A (self-association)
-    eA.addAssociation({ key: eA.key }, { info: { name: 'assocAA' } })
+    eA.addAssociation({ info: { name: 'assocAA' }, targets: [{ key: eA.key }] })
     const model = new ApiModel()
     model.attachDataDomain(domain)
     model.exposeEntity({ key: eA.key }, { followAssociations: true })
@@ -132,8 +132,8 @@ test.group('ApiModel.exposeEntity()', () => {
     const eA = dm.addEntity({ info: { name: 'A' } })
     const eB = dm.addEntity({ info: { name: 'B' } })
     const eC = dm.addEntity({ info: { name: 'C' } })
-    eA.addAssociation({ key: eB.key }, { info: { name: 'toB' } })
-    eB.addAssociation({ key: eC.key }, { info: { name: 'toC' } })
+    eA.addAssociation({ info: { name: 'toB' }, targets: [{ key: eB.key }] })
+    eB.addAssociation({ info: { name: 'toC' }, targets: [{ key: eC.key }] })
     const model = new ApiModel()
     model.attachDataDomain(domain)
     model.exposeEntity({ key: eA.key }, { followAssociations: true })
@@ -152,8 +152,8 @@ test.group('ApiModel.exposeEntity()', () => {
     const eA = dm.addEntity({ info: { name: 'A' } })
     const eB = dm.addEntity({ info: { name: 'B' } })
     const eC = dm.addEntity({ info: { name: 'C' } })
-    eA.addAssociation({ key: eB.key }, { info: { name: 'toB' } })
-    eA.addAssociation({ key: eC.key }, { info: { name: 'toC' } })
+    eA.addAssociation({ info: { name: 'toB' }, targets: [{ key: eB.key }] })
+    eA.addAssociation({ info: { name: 'toC' }, targets: [{ key: eC.key }] })
     const model = new ApiModel()
     model.attachDataDomain(domain)
     model.exposeEntity({ key: eA.key }, { followAssociations: true })
@@ -173,9 +173,9 @@ test.group('ApiModel.exposeEntity()', () => {
     const eB = dm.addEntity({ info: { name: 'B' } })
     const eC = dm.addEntity({ info: { name: 'C' } })
     const eD = dm.addEntity({ info: { name: 'D' } })
-    eA.addAssociation({ key: eB.key }, { info: { name: 'toB' } })
-    eB.addAssociation({ key: eC.key }, { info: { name: 'toC' } })
-    eC.addAssociation({ key: eD.key }, { info: { name: 'toD' } })
+    eA.addAssociation({ info: { name: 'toB' }, targets: [{ key: eB.key }] })
+    eB.addAssociation({ info: { name: 'toC' }, targets: [{ key: eC.key }] })
+    eC.addAssociation({ info: { name: 'toD' }, targets: [{ key: eD.key }] })
     const model = new ApiModel()
     model.attachDataDomain(domain)
     model.exposeEntity({ key: eA.key }, { followAssociations: true, maxDepth: 2 })

package/tests/unit/modeling/api_model_remove_entity.spec.ts

@@ -23,7 +23,7 @@ test.group('ApiModel.removeEntity()', () => {
     const eA = dm.addEntity({ info: { name: 'A' } })
     const eB = dm.addEntity({ info: { name: 'B' } })
     // A -> B
-    eA.addAssociation({ key: eB.key }, { info: { name: 'toB' } })
+    eA.addAssociation({ info: { name: 'toB' }, targets: [{ key: eB.key }] })
     const model = new ApiModel()
     model.attachDataDomain(domain)
     const rootExposure = model.exposeEntity({ key: eA.key }, { followAssociations: true })

package/tests/unit/modeling/data_domain_associations.spec.ts

@@ -17,7 +17,7 @@ test.group('DataDomain.addAssociation()', () => {
     const model = dataDomain.addModel({ key: 'test-model' })
     const entity1 = dataDomain.addEntity(model.key, { key: 'entity1' })
     const entity2 = dataDomain.addEntity(model.key, { key: 'entity2' })
-    const association = dataDomain.addAssociation(entity1.key, { key: entity2.key })
+    const association = dataDomain.addAssociation(entity1.key, { targets: [{ key: entity2.key }] })
     assert.instanceOf(association, DomainAssociation)
     assert.isTrue(dataDomain.graph.hasNode(association.key))
   }).tags(['@modeling', '@associations', '@add'])
@@ -84,7 +84,7 @@ test.group('DataDomain.addAssociation()', () => {
 
     domain1.registerForeignDomain(domain2)
 
-    const association = domain1.addAssociation(e1.key, { key: 'entity2', domain: domain2.key })
+    const association = domain1.addAssociation(e1.key, { targets: [{ key: 'entity2', domain: domain2.key }] })
     assert.instanceOf(association, DomainAssociation)
     assert.isTrue(domain1.graph.hasNode(association.key))
   }).tags(['@modeling', '@associations', '@add'])
@@ -99,7 +99,7 @@ test.group('DataDomain.addAssociation()', () => {
     domain1.registerForeignDomain(domain2)
 
     assert.throws(() => {
-      domain1.addAssociation(e1.key, { key: 'non-existent-entity', domain: 'domain2' })
+      domain1.addAssociation(e1.key, { targets: [{ key: 'non-existent-entity', domain: 'domain2' }] })
     }, 'Foreign entity domain2:non-existent-entity not found')
   }).tags(['@modeling', '@associations', '@add'])
 })
@@ -159,7 +159,7 @@ test.group('DataDomain.removeAssociation()', () => {
     domain2.info.version = '1.0.0'
     domain1.registerForeignDomain(domain2)
 
-    const association = domain1.addAssociation(e1.key, { key: e2.key, domain: domain2.key })
+    const association = domain1.addAssociation(e1.key, { targets: [{ key: e2.key, domain: domain2.key }] })
     domain1.removeAssociation(association.key)
     assert.isFalse(domain1.graph.hasNode(association.key))
   }).tags(['@modeling', '@associations', '@remove'])
@@ -187,7 +187,7 @@ test.group('DataDomain.removeAssociation()', () => {
     const model = dataDomain.addModel()
     const entity1 = dataDomain.addEntity(model.key, { key: 'entity1' })
     const entity2 = dataDomain.addEntity(model.key, { key: 'entity2' })
-    const association = dataDomain.addAssociation(entity1.key, { key: entity2.key })
+    const association = dataDomain.addAssociation(entity1.key, { targets: [{ key: entity2.key }] })
     dataDomain.removeAssociation(association.key)
     assert.isTrue(dataDomain.graph.hasNode(entity1.key))
     assert.isTrue(dataDomain.graph.hasNode(entity2.key))
@@ -282,7 +282,7 @@ test.group('DataDomain.findAssociation()', () => {
     const e2 = domain2.addEntity(m2.key, { key: 'entity2' })
     domain2.info.version = '1.0.0'
     domain1.registerForeignDomain(domain2)
-    const association = domain1.addAssociation(e1.key, { key: e2.key, domain: domain2.key })
+    const association = domain1.addAssociation(e1.key, { targets: [{ key: e2.key, domain: domain2.key }] })
 
     const foundAssociation = domain1.findAssociation(association.key)
     assert.deepEqual(foundAssociation, association)

package/tests/unit/modeling/data_domain_foreign.spec.ts

@@ -118,7 +118,7 @@ test.group('DataDomain.registerForeignDomain()', () => {
     const model = foreignDomain.addModel({ key: 'test-model' })
     const entity1 = foreignDomain.addEntity(model.key, { key: 'entity1' })
     const entity2 = foreignDomain.addEntity(model.key, { key: 'entity2' })
-    const association = entity1.addAssociation({ key: entity2.key })
+    const association = entity1.addAssociation({ targets: [{ key: entity2.key }] })
     foreignDomain.info.version = '1.0.0'
     dataDomain.registerForeignDomain(foreignDomain)
 
@@ -606,7 +606,7 @@ test.group('DataDomain.findAssociation()', () => {
     const m1 = fd.addModel()
     const e1 = m1.addEntity()
     const e2 = m1.addEntity()
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
     fd.info.version = '1.0.0'
     domain.registerForeignDomain(fd)
     const result = domain.findAssociation(a1.key, fd.key)

package/tests/unit/modeling/data_domain_namespaces.spec.ts

@@ -143,7 +143,7 @@ test.group('DataDomain.removeNamespace()', () => {
     const e1 = m1.addEntity({ key: 'entity1' })
     const e2 = m1.addEntity({ key: 'entity2' })
     const p1 = e1.addProperty({ key: 'property1' })
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
     d1.removeNamespace(ns1.key)
     assert.isFalse(d1.graph.hasNode(ns1.key))
     assert.isFalse(d1.graph.hasNode(ns2.key))

package/tests/unit/modeling/data_domain_serialization.spec.ts

@@ -139,7 +139,7 @@ test.group('DataDomain Serialization and Deserialization', () => {
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
     const e2 = m1.addEntity()
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
 
     const serialized = domain.toJSON()
     const restored = new DataDomain(serialized)
@@ -168,7 +168,7 @@ test.group('DataDomain Serialization and Deserialization', () => {
     e2.addParent(e1.key)
     const p1 = e1.addProperty({ type: 'string' })
     const p2 = e2.addProperty({ type: 'number' })
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
 
     const serialized = domain.toJSON()
     const restored = new DataDomain(serialized)
@@ -249,7 +249,7 @@ test.group('DataDomain Serialization and Deserialization', () => {
     domain.registerForeignDomain(fd)
     const m1 = domain.addModel({ key: 'm1' })
     const e1 = m1.addEntity({ key: 'e1' })
-    const a1 = e1.addAssociation({ key: fe1.key, domain: fd.key }, { key: 'a1' })
+    const a1 = e1.addAssociation({ key: 'a1', targets: [{ key: fe1.key, domain: fd.key }] })
     const serialized = domain.toJSON()
     const restored = new DataDomain(serialized, [fd])
 
@@ -278,7 +278,7 @@ test.group('DataDomain Serialization and Deserialization', () => {
     domain.registerForeignDomain(fd)
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
-    const a1 = e1.addAssociation({ key: fe1.key, domain: fd.key })
+    const a1 = e1.addAssociation({ targets: [{ key: fe1.key, domain: fd.key }] })
 
     const serialized = domain.toJSON()
     const restored = new DataDomain(serialized)
@@ -311,7 +311,7 @@ test.group('DataDomain Serialization and Deserialization', () => {
     // Add properties and associations
     const p1 = e1.addProperty({ type: 'string', key: 'p1' })
     const p2 = e2.addProperty({ type: 'number', key: 'p2' })
-    const a1 = e1.addAssociation({ key: e3.key }, { key: 'a1' })
+    const a1 = e1.addAssociation({ targets: [{ key: e3.key }], key: 'a1' })
 
     const serialized = domain.toJSON()
     const restored = new DataDomain(serialized)
@@ -411,7 +411,7 @@ test.group('Validation Tests', () => {
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
     const e2 = m1.addEntity()
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
 
     // Manually break the graph by removing the association edge to parent
     domain.graph.removeEdge(e1.key, a1.key)
@@ -461,7 +461,7 @@ test.group('Validation Tests', () => {
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
     const e2 = m1.addEntity()
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
 
     // Remove the association target edge
     domain.graph.removeEdge(a1.key, e2.key)
@@ -478,7 +478,7 @@ test.group('Validation Tests', () => {
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
     const e2 = m1.addEntity()
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
 
     // Remove the target entity but keep the edge pointing to it
     domain.graph.removeNode(e2.key)
@@ -493,7 +493,7 @@ test.group('Validation Tests', () => {
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
     const e2 = m1.addEntity()
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
 
     // Remove the proper target and make it point to the model instead
     domain.graph.removeEdge(a1.key, e2.key)
@@ -512,7 +512,7 @@ test.group('Validation Tests', () => {
     const e1 = m1.addEntity()
     const e2 = m2.addEntity()
     e1.addProperty({ type: 'string' })
-    e1.addAssociation({ key: e2.key })
+    e1.addAssociation({ targets: [{ key: e2.key }] })
 
     // This should not throw any validation errors
     assert.doesNotThrow(() => {
@@ -529,7 +529,7 @@ test.group('Validation Tests', () => {
     const e1 = m1.addEntity()
     const e2 = m2.addEntity()
     e1.addProperty({ type: 'string' })
-    e1.addAssociation({ key: e2.key })
+    e1.addAssociation({ targets: [{ key: e2.key }] })
 
     // This should not throw any validation errors
     assert.doesNotThrow(() => {
@@ -547,7 +547,7 @@ test.group('Validation Tests', () => {
     domain.registerForeignDomain(fd)
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
-    e1.addAssociation({ key: fe1.key, domain: fd.key })
+    e1.addAssociation({ targets: [{ key: fe1.key, domain: fd.key }] })
 
     // Foreign associations should pass validation
     assert.doesNotThrow(() => {
@@ -630,7 +630,7 @@ test.group('DataDomain Lenient Mode Deserialization', () => {
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
     const e2 = m1.addEntity()
-    const a1 = e1.addAssociation({ key: e2.key })
+    const a1 = e1.addAssociation({ targets: [{ key: e2.key }] })
 
     const serialized = domain.toJSON()
 
@@ -701,7 +701,7 @@ test.group('DataDomain Lenient Mode Deserialization', () => {
     domain.registerForeignDomain(fd)
     const m1 = domain.addModel()
     const e1 = m1.addEntity()
-    e1.addAssociation({ key: fe1.key, domain: fd.key })
+    e1.addAssociation({ targets: [{ key: fe1.key, domain: fd.key }] })
 
     const serialized = domain.toJSON()
 
@@ -762,7 +762,7 @@ test.group('DataDomain Lenient Mode Deserialization', () => {
     const e1 = m1.addEntity()
     const e2 = m1.addEntity()
     const p1 = e1.addProperty({ type: 'string' })
-    e1.addAssociation({ key: e2.key })
+    e1.addAssociation({ targets: [{ key: e2.key }] })
 
     const serialized = domain.toJSON()
 

package/tests/unit/modeling/domain_asociation.spec.ts

@@ -916,7 +916,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'originalAssociation'
     association.required = true
     association.multiple = false
@@ -938,7 +938,7 @@ test.group('DomainAssociation.duplicate()', () => {
 
     // Add multiple fields to test ordering
     const property1 = entity.addProperty({ info: { name: 'first' } })
-    const association1 = entity.addAssociation({ key: targetEntity.key })
+    const association1 = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association1.info.name = 'originalAssoc'
     const property2 = entity.addProperty({ info: { name: 'second' } })
 
@@ -959,10 +959,10 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'test'
     // Add another association that conflicts with the first generated name
-    const conflictAssoc = entity.addAssociation({ key: targetEntity.key })
+    const conflictAssoc = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     conflictAssoc.info.name = 'test_copy'
 
     const duplicate = association.duplicate()
@@ -976,7 +976,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     // The association gets the default name "new_association" from schema creation
     assert.equal(association.info.name, 'new_association')
 
@@ -991,7 +991,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'test'
     // Manually set name to undefined to test the fallback logic
     association.info.name = undefined
@@ -1007,7 +1007,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     const originalKey = association.key
 
     const duplicate = association.duplicate()
@@ -1022,7 +1022,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const targetEntity1 = model.addEntity()
     const targetEntity2 = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity1.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity1.key }] })
     association.addTarget(targetEntity2.key)
     association.info.name = 'multiTarget'
 
@@ -1047,7 +1047,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'complexAssociation'
     association.info.description = 'A complex association'
     association.required = true
@@ -1077,7 +1077,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'original'
     association.schema = { linked: false, unionType: 'anyOf' }
     association.bindings = [{ type: 'web', schema: { hidden: false } }]
@@ -1134,7 +1134,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
 
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'test'
 
     let notificationCalled = false
@@ -1184,7 +1184,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const model = dataDomain.addModel()
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'only'
 
     const duplicate = association.duplicate()
@@ -1201,7 +1201,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const targetEntity = model.addEntity()
 
     const property1 = entity.addProperty({ info: { name: 'prop1' } })
-    const association1 = entity.addAssociation({ key: targetEntity.key })
+    const association1 = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association1.info.name = 'assoc1'
     const property2 = entity.addProperty({ info: { name: 'prop2' } })
 
@@ -1217,7 +1217,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const model = dataDomain.addModel()
     const entity = model.addEntity()
     const targetEntity = model.addEntity()
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
 
     const duplicate = association.duplicate()
 
@@ -1268,7 +1268,7 @@ test.group('DomainAssociation.duplicate()', () => {
     const entity = model.addEntity()
     dataDomain.registerForeignDomain(fd)
 
-    const association = entity.addAssociation({ key: fe1.key, domain: fd.key })
+    const association = entity.addAssociation({ targets: [{ key: fe1.key, domain: fd.key }] })
 
     const duplicate = association.duplicate()
 

package/tests/unit/modeling/domain_entity.spec.ts

@@ -785,7 +785,7 @@ test.group('DomainEntity.generateUniqueName()', () => {
     const targetEntity = model.addEntity()
 
     // Add an association that conflicts with the first generated name
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'test_copy'
 
     const uniqueName = entity.generateUniqueName('test')
@@ -800,7 +800,7 @@ test.group('DomainEntity.generateUniqueName()', () => {
 
     // Add property and association with conflicting names
     entity.addProperty({ info: { name: 'test_copy' } })
-    const association = entity.addAssociation({ key: targetEntity.key })
+    const association = entity.addAssociation({ targets: [{ key: targetEntity.key }] })
     association.info.name = 'test_copy_2'
 
     const uniqueName = entity.generateUniqueName('test')
@@ -816,7 +816,7 @@ test.group('DomainEntity.generateUniqueName()', () => {
     // Add property without a name (undefined name)
     entity.addProperty({ info: {} })
     // Add association without a name
-    entity.addAssociation({ key: targetEntity.key })
+    entity.addAssociation({ targets: [{ key: targetEntity.key }] })
 
     const uniqueName = entity.generateUniqueName('test')
     assert.equal(uniqueName, 'test_copy')