@api-client/core 0.19.23 → 0.19.25

package/build/src/mocking/lib/Deployment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Deployment.js","sourceRoot":"","sources":["../../../../src/mocking/lib/Deployment.ts"],"names":[],"mappings":"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","sourcesContent":["import { faker } from '@faker-js/faker'\nimport { nanoid } from '../../nanoid.js'\nimport { DeploymentEnvironment, DeploymentKind, DeploymentStatus } from '../../models/store/Deployment.js'\nimport type { DeploymentSchema } from '../../models/store/Deployment.js'\n\nconst deploymentEnvironments: DeploymentEnvironment[] = [\n  DeploymentEnvironment.PROD,\n  DeploymentEnvironment.STAGING,\n  DeploymentEnvironment.DEV,\n] as const\n\nexport class Deployment {\n  /**\n   * Generates a random deployment object.\n   * @param init Optional values to be present in the object.\n   * @returns Random deployment object.\n   */\n  deployment(init: Partial<DeploymentSchema> = {}): DeploymentSchema {\n    const env = init.env ?? faker.helpers.arrayElement(deploymentEnvironments)\n    let version: string | undefined\n    if (init.version !== undefined) {\n      version = init.version\n    } else if (env === DeploymentEnvironment.PROD) {\n      version = `v${faker.number.int({ min: 1, max: 5 })}`\n    } else {\n      version = undefined\n    }\n\n    const {\n      key = nanoid(),\n      orgId = nanoid(),\n      apiId = nanoid(),\n      orgSlug = faker.internet.domainWord(),\n      apiSlug = faker.internet.domainWord(),\n      modelVersion = faker.system.semver(),\n      status = faker.helpers.arrayElement([\n        DeploymentStatus.Pending,\n        DeploymentStatus.Active,\n        DeploymentStatus.Inactive,\n        DeploymentStatus.Failed,\n      ] as const),\n      createdAt = faker.date.past().getTime(),\n      updatedAt = faker.date.recent().getTime(),\n    } = init\n\n    const result: DeploymentSchema = {\n      kind: DeploymentKind,\n      key,\n      orgId,\n      apiId,\n      orgSlug,\n      apiSlug,\n      env,\n      modelVersion,\n      status,\n      createdAt,\n      updatedAt,\n    }\n    if (version !== undefined && version !== '') {\n      result.version = version\n    }\n    if (status === DeploymentStatus.Active) {\n      result.baseUri = init.baseUri ?? faker.internet.url()\n      result.portalUri = init.portalUri ?? faker.internet.url()\n    } else {\n      if (init.baseUri !== undefined) {\n        result.baseUri = init.baseUri\n      }\n      if (init.portalUri !== undefined) {\n        result.portalUri = init.portalUri\n      }\n    }\n    return result\n  }\n\n  /**\n   * Generates a list of random deployment objects.\n   * @param size Number of deployments to generate. Default is 25.\n   * @returns List of random deployments\n   */\n  deployments(size = 25, init?: Partial<DeploymentSchema>): DeploymentSchema[] {\n    const result: DeploymentSchema[] = []\n    for (let i = 0; i < size; i++) {\n      result.push(this.deployment(init))\n    }\n    return result\n  }\n}\n"]}

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

@@ -126,6 +126,10 @@ export interface AssociationWebBindings {
      * Whether the association is hidden in the schema (not a part of it).
      */
     hidden?: boolean;
+    /**
+     * When set it overrides the `name` of the property.
+     */
+    name?: string;
 }
 export type AssociationBindings = AssociationWebBindings;
 export interface AssociationBinding extends Binding {

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

@@ -1 +1 @@
-{"version":3,"file":"Bindings.d.ts","sourceRoot":"","sources":["../../../src/modeling/Bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE3D,UAAU,OAAO;IACf;;;;;OAKG;IACH,IAAI,EAAE,UAAU,GAAG,KAAK,CAAA;IACxB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAA;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,EACL,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,MAAM,GACN,QAAQ,GACR,OAAO,CAAA;CACZ;AAED,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG,wBAAwB,CAAA;AAE7E,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C;;;;;OAKG;IACH,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,CAAA;AAExD,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IACjD;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAA;CAC5B"}
+{"version":3,"file":"Bindings.d.ts","sourceRoot":"","sources":["../../../src/modeling/Bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAE3D,UAAU,OAAO;IACf;;;;;OAKG;IACH,IAAI,EAAE,UAAU,GAAG,KAAK,CAAA;IACxB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAA;IAC7B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAA;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,QAAQ,CAAC,EACL,QAAQ,GACR,OAAO,GACP,OAAO,GACP,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,SAAS,GACT,UAAU,GACV,UAAU,GACV,MAAM,GACN,QAAQ,GACR,OAAO,CAAA;CACZ;AAED,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG,wBAAwB,CAAA;AAE7E,MAAM,WAAW,eAAgB,SAAQ,OAAO;IAC9C;;;;;OAKG;IACH,MAAM,EAAE,gBAAgB,CAAA;CACzB;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,MAAM,mBAAmB,GAAG,sBAAsB,CAAA;AAExD,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IACjD;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAA;CAC5B"}

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

@@ -1 +1 @@
-{"version":3,"file":"Bindings.js","sourceRoot":"","sources":["../../../src/modeling/Bindings.ts"],"names":[],"mappings":"","sourcesContent":["import type { Shapes } from '@api-client/amf-core'\nimport type { DomainPropertyFormat } from './DataFormat.js'\n\ninterface Binding {\n  /**\n   * The type of the bindings\n   *\n   * - Protocol buffers: `protobuf`\n   * - RAML or OAS - `web`\n   */\n  type: 'protobuf' | 'web'\n  /**\n   * The binding schema.\n   */\n  schema: unknown\n}\n\n/**\n * Binding for web API schema types (RAML, OAS)\n *\n * Data type translation (type to dataType)\n *\n * - `string` -> `string` with appropriate format\n * - `number` -> `number` data type with format `float`, `double`, or none format for OAS\n * - `integer` -> `integer` data type with `int32`, `int64`, or none format for OAS\n * - `nil` -> `nullable` property on OAS or `nil` type in RAML\n * - `boolean` -> `boolean` (both the same)\n * - `date` ->\n * - `any` -> `any` in RAML, `{}` shorthand in OAS\n *\n *\n *\n * The `binary` type\n *\n * OAS\n *\n * `http://www.w3.org/2001/XMLSchema#byte` For a file\n * `http://www.w3.org/2001/XMLSchema#base64Binary` for base 64\n *\n * RAML\n *\n * Has it's own AMF shape: FileShape.\n *\n * The `data` type\n *\n * OAS\n *\n * `http://www.w3.org/2001/XMLSchema#date` for a `date`\n * `http://www.w3.org/2001/XMLSchema#dateTime` for a `datetime` and `time`.\n * Note, OAS has no concept of `time` do we add `time` as the `format which is a custom thing.\n *\n * RAML\n *\n * `http://www.w3.org/2001/XMLSchema#date` for a `date` (raml's date-only)\n * `http://a.ml/vocabularies/shapes#dateTimeOnly` for a `time` (raml's time-only)\n * `http://www.w3.org/2001/XMLSchema#dateTime` for a `datetime` (raml's datetime) + format\n *\n * Note, we won't support RAML's `datetime-only`.\n */\nexport interface PropertyWebBindings {\n  /**\n   * The format specifying the property data type.\n   */\n  format?: DomainPropertyFormat\n  /**\n   * When set it overrides the `name` of the property.\n   */\n  name?: string\n  /**\n   * The XML encoding instructions.\n   */\n  xml?: Shapes.IApiXmlSerializer\n  /**\n   * Only valid for the `file` property type.\n   * The list of file mime types.\n   */\n  fileTypes?: string[]\n  /**\n   * Whether the attribute is hidden in the schema (not a part of it).\n   */\n  hidden?: boolean\n}\n\n/**\n * Binding to the protocol buffer.\n *\n * Data type translation (type to dataType)\n *\n * - `string` -> `string`\n * - `number` -> `double`, `float`\n * - `integer` -> `int32`, `int64`, `uint32`, `uint64`, `sint32`, `sint64`, `fixed32`, `fixed64`, `sfixed32`, `sfixed64`\n * - `nil` -> No translation.\n * - `boolean` -> `boolean`\n * - `date` -> No translation, we allow string or number (date string or a timestamp with a\n *    combination with format but this is not standard for ProtoBuf)\n * - `any` -> No translation, the user has to pick any of the data formats.\n * - `binary` -> `bytes`\n */\nexport interface PropertyProtobufBindings {\n  /**\n   * The field number in a protocol buffer message\n   */\n  field?: number\n  /**\n   * Whether this property (field) is reserved\n   */\n  reserved?: boolean\n  /**\n   * Whether the attribute is hidden in the schema (not a part of it).\n   */\n  hidden?: boolean\n  /**\n   * The data type of the protocol buffer proprty\n   */\n  dataType?:\n    | 'double'\n    | 'float'\n    | 'int32'\n    | 'int64'\n    | 'uint32'\n    | 'uint64'\n    | 'sint32'\n    | 'sint64'\n    | 'fixed32'\n    | 'fixed64'\n    | 'sfixed32'\n    | 'sfixed64'\n    | 'bool'\n    | 'string'\n    | 'bytes'\n}\n\nexport type PropertyBindings = PropertyWebBindings | PropertyProtobufBindings\n\nexport interface PropertyBinding extends Binding {\n  /**\n   * The definition of the bindings.\n   * The bindings tells how to translated the DomainProperty to a specific format.\n   * For example, it allows to define the `dataType` and `format` for RAML / OAS (via the AMF shapes)\n   * or the field number for protocol buffer.\n   */\n  schema: PropertyBindings\n}\n\nexport interface AssociationWebBindings {\n  /**\n   * Whether the association is hidden in the schema (not a part of it).\n   */\n  hidden?: boolean\n}\n\nexport type AssociationBindings = AssociationWebBindings\n\nexport interface AssociationBinding extends Binding {\n  /**\n   * Association binding definition.\n   */\n  schema: AssociationBindings\n}\n"]}
+{"version":3,"file":"Bindings.js","sourceRoot":"","sources":["../../../src/modeling/Bindings.ts"],"names":[],"mappings":"","sourcesContent":["import type { Shapes } from '@api-client/amf-core'\nimport type { DomainPropertyFormat } from './DataFormat.js'\n\ninterface Binding {\n  /**\n   * The type of the bindings\n   *\n   * - Protocol buffers: `protobuf`\n   * - RAML or OAS - `web`\n   */\n  type: 'protobuf' | 'web'\n  /**\n   * The binding schema.\n   */\n  schema: unknown\n}\n\n/**\n * Binding for web API schema types (RAML, OAS)\n *\n * Data type translation (type to dataType)\n *\n * - `string` -> `string` with appropriate format\n * - `number` -> `number` data type with format `float`, `double`, or none format for OAS\n * - `integer` -> `integer` data type with `int32`, `int64`, or none format for OAS\n * - `nil` -> `nullable` property on OAS or `nil` type in RAML\n * - `boolean` -> `boolean` (both the same)\n * - `date` ->\n * - `any` -> `any` in RAML, `{}` shorthand in OAS\n *\n *\n *\n * The `binary` type\n *\n * OAS\n *\n * `http://www.w3.org/2001/XMLSchema#byte` For a file\n * `http://www.w3.org/2001/XMLSchema#base64Binary` for base 64\n *\n * RAML\n *\n * Has it's own AMF shape: FileShape.\n *\n * The `data` type\n *\n * OAS\n *\n * `http://www.w3.org/2001/XMLSchema#date` for a `date`\n * `http://www.w3.org/2001/XMLSchema#dateTime` for a `datetime` and `time`.\n * Note, OAS has no concept of `time` do we add `time` as the `format which is a custom thing.\n *\n * RAML\n *\n * `http://www.w3.org/2001/XMLSchema#date` for a `date` (raml's date-only)\n * `http://a.ml/vocabularies/shapes#dateTimeOnly` for a `time` (raml's time-only)\n * `http://www.w3.org/2001/XMLSchema#dateTime` for a `datetime` (raml's datetime) + format\n *\n * Note, we won't support RAML's `datetime-only`.\n */\nexport interface PropertyWebBindings {\n  /**\n   * The format specifying the property data type.\n   */\n  format?: DomainPropertyFormat\n  /**\n   * When set it overrides the `name` of the property.\n   */\n  name?: string\n  /**\n   * The XML encoding instructions.\n   */\n  xml?: Shapes.IApiXmlSerializer\n  /**\n   * Only valid for the `file` property type.\n   * The list of file mime types.\n   */\n  fileTypes?: string[]\n  /**\n   * Whether the attribute is hidden in the schema (not a part of it).\n   */\n  hidden?: boolean\n}\n\n/**\n * Binding to the protocol buffer.\n *\n * Data type translation (type to dataType)\n *\n * - `string` -> `string`\n * - `number` -> `double`, `float`\n * - `integer` -> `int32`, `int64`, `uint32`, `uint64`, `sint32`, `sint64`, `fixed32`, `fixed64`, `sfixed32`, `sfixed64`\n * - `nil` -> No translation.\n * - `boolean` -> `boolean`\n * - `date` -> No translation, we allow string or number (date string or a timestamp with a\n *    combination with format but this is not standard for ProtoBuf)\n * - `any` -> No translation, the user has to pick any of the data formats.\n * - `binary` -> `bytes`\n */\nexport interface PropertyProtobufBindings {\n  /**\n   * The field number in a protocol buffer message\n   */\n  field?: number\n  /**\n   * Whether this property (field) is reserved\n   */\n  reserved?: boolean\n  /**\n   * Whether the attribute is hidden in the schema (not a part of it).\n   */\n  hidden?: boolean\n  /**\n   * The data type of the protocol buffer proprty\n   */\n  dataType?:\n    | 'double'\n    | 'float'\n    | 'int32'\n    | 'int64'\n    | 'uint32'\n    | 'uint64'\n    | 'sint32'\n    | 'sint64'\n    | 'fixed32'\n    | 'fixed64'\n    | 'sfixed32'\n    | 'sfixed64'\n    | 'bool'\n    | 'string'\n    | 'bytes'\n}\n\nexport type PropertyBindings = PropertyWebBindings | PropertyProtobufBindings\n\nexport interface PropertyBinding extends Binding {\n  /**\n   * The definition of the bindings.\n   * The bindings tells how to translated the DomainProperty to a specific format.\n   * For example, it allows to define the `dataType` and `format` for RAML / OAS (via the AMF shapes)\n   * or the field number for protocol buffer.\n   */\n  schema: PropertyBindings\n}\n\nexport interface AssociationWebBindings {\n  /**\n   * Whether the association is hidden in the schema (not a part of it).\n   */\n  hidden?: boolean\n  /**\n   * When set it overrides the `name` of the property.\n   */\n  name?: string\n}\n\nexport type AssociationBindings = AssociationWebBindings\n\nexport interface AssociationBinding extends Binding {\n  /**\n   * Association binding definition.\n   */\n  schema: AssociationBindings\n}\n"]}

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

@@ -12,7 +12,7 @@ export declare enum DomainPropertyList {
 /**
  * The data property "attributes".
  */
-export type DomainPropertyAttribute = 'required' | 'multiple' | 'primary' | 'index' | 'readOnly' | 'writeOnly' | 'deprecated';
+export type DomainPropertyAttribute = 'required' | 'multiple' | 'primary' | 'index' | 'unique' | 'search' | 'readOnly' | 'writeOnly' | 'deprecated';
 export declare const DomainPropertyAttributes: DomainPropertyAttribute[];
 /**
  * The data attribute "attributes".

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

@@ -1 +1 @@
-{"version":3,"file":"DataFormat.d.ts","sourceRoot":"","sources":["../../../src/modeling/DataFormat.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GAER,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,GAEN,QAAQ,CAAA;AAEZ,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,EAoBnD,CAAA;AAED,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,MAAM,WAAW;IAEjB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,IAAI,SAAS;IAEb,IAAI,WAAW;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,UAAU,GACV,UAAU,GACV,SAAS,GACT,OAAO,GACP,UAAU,GACV,WAAW,GACX,YAAY,CAAA;AAEhB,eAAO,MAAM,wBAAwB,EAAE,uBAAuB,EAQ7D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,UAAU,CAAA;AAE9D,eAAO,MAAM,yBAAyB,EAAE,wBAAwB,EAA6B,CAAA;AAE7F;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAEjE,eAAO,MAAM,aAAa,EAAE,YAAY,EAA0C,CAAA;AAElF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE3C,eAAO,MAAM,aAAa,EAAE,YAAY,EAAsB,CAAA;AAE9D,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,YAAY,CAAA"}
+{"version":3,"file":"DataFormat.d.ts","sourceRoot":"","sources":["../../../src/modeling/DataFormat.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GAER,SAAS,GACT,MAAM,GACN,UAAU,GACV,MAAM,GAEN,QAAQ,CAAA;AAEZ,eAAO,MAAM,mBAAmB,EAAE,kBAAkB,EAoBnD,CAAA;AAED,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,MAAM,WAAW;IAEjB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,QAAQ,aAAa;IACrB,IAAI,SAAS;IAEb,IAAI,WAAW;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAC/B,UAAU,GACV,UAAU,GACV,SAAS,GACT,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,WAAW,GACX,YAAY,CAAA;AAEhB,eAAO,MAAM,wBAAwB,EAAE,uBAAuB,EAU7D,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,UAAU,GAAG,UAAU,CAAA;AAE9D,eAAO,MAAM,yBAAyB,EAAE,wBAAwB,EAA6B,CAAA;AAE7F;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAA;AAEjE,eAAO,MAAM,aAAa,EAAE,YAAY,EAA0C,CAAA;AAElF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE3C,eAAO,MAAM,aAAa,EAAE,YAAY,EAAsB,CAAA;AAE9D,MAAM,MAAM,oBAAoB,GAAG,YAAY,GAAG,YAAY,CAAA"}

package/build/src/modeling/DataFormat.js

@@ -36,6 +36,8 @@ export const DomainPropertyAttributes = [
     'multiple',
     'primary',
     'index',
+    'unique',
+    'search',
     'readOnly',
     'writeOnly',
     'deprecated',

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

@@ -1 +1 @@
-{"version":3,"file":"DataFormat.js","sourceRoot":"","sources":["../../../src/modeling/DataFormat.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,mBAAmB,GAAyB;IACvD,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;IACT;;;;OAIG;IACH,MAAM;IACN;;;;OAIG;IACH,UAAU;IACV,MAAM;IACN,SAAS;IACT,QAAQ;CACT,CAAA;AAED,MAAM,CAAN,IAAY,kBAUX;AAVD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,eAAe;IACf,yCAAmB,CAAA;IACnB,mCAAa,CAAA;IACb,2CAAqB,CAAA;IACrB,mCAAa,CAAA;IACb,eAAe;IACf,qCAAe,CAAA;AACjB,CAAC,EAVW,kBAAkB,KAAlB,kBAAkB,QAU7B;AAcD,MAAM,CAAC,MAAM,wBAAwB,GAA8B;IACjE,UAAU;IACV,UAAU;IACV,SAAS;IACT,OAAO;IACP,UAAU;IACV,WAAW;IACX,YAAY;CACb,CAAA;AAOD,MAAM,CAAC,MAAM,yBAAyB,GAA+B,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAa7F,MAAM,CAAC,MAAM,aAAa,GAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAQlF,MAAM,CAAC,MAAM,aAAa,GAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA","sourcesContent":["export type DomainPropertyType =\n  | 'string'\n  | 'number'\n  // | 'nil'\n  | 'boolean'\n  | 'date'\n  | 'datetime'\n  | 'time'\n  // | 'any'\n  | 'binary'\n\nexport const DomainPropertyTypes: DomainPropertyType[] = [\n  'string',\n  'number',\n  // 'nil',\n  'boolean',\n  /**\n   * full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21\n   *\n   * @see {@link https://tools.ietf.org/html/rfc3339#section-5.6}\n   */\n  'date',\n  /**\n   * the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z\n   *\n   * @see {@link https://tools.ietf.org/html/rfc3339#section-5.6}\n   */\n  'datetime',\n  'time',\n  // 'any',\n  'binary',\n]\n\nexport enum DomainPropertyList {\n  string = 'string',\n  number = 'number',\n  // nil = 'nil',\n  boolean = 'boolean',\n  date = 'date',\n  datetime = 'datetime',\n  time = 'time',\n  // any = 'any',\n  file = 'binary',\n}\n\n/**\n * The data property \"attributes\".\n */\nexport type DomainPropertyAttribute =\n  | 'required'\n  | 'multiple'\n  | 'primary'\n  | 'index'\n  | 'readOnly'\n  | 'writeOnly'\n  | 'deprecated'\n\nexport const DomainPropertyAttributes: DomainPropertyAttribute[] = [\n  'required',\n  'multiple',\n  'primary',\n  'index',\n  'readOnly',\n  'writeOnly',\n  'deprecated',\n]\n\n/**\n * The data attribute \"attributes\".\n */\nexport type DomainAttributeAttribute = 'required' | 'multiple'\n\nexport const DomainAttributeAttributes: DomainAttributeAttribute[] = ['required', 'multiple']\n\n/**\n * Note, OAS supports the `integer` data type and not format.\n * We need to account for that.\n *\n * - `float` - 32-bit floating point numbers\n * - `double` - 64-bit floating point numbers\n * - `int32` - Signed 32 bit number\n * - `int64` - Signed 64 bit number (OAS `long`)\n */\nexport type NumberFormat = 'float' | 'double' | 'int32' | 'int64'\n\nexport const NumberFormats: NumberFormat[] = ['float', 'double', 'int32', 'int64']\n\n/**\n * - `hex` - Hex-encoded binary data\n * - `base64` - Base64-encoded binary data\n */\nexport type BinaryFormat = 'hex' | 'base64'\n\nexport const BinaryFormats: BinaryFormat[] = ['hex', 'base64']\n\nexport type DomainPropertyFormat = NumberFormat | BinaryFormat\n"]}
+{"version":3,"file":"DataFormat.js","sourceRoot":"","sources":["../../../src/modeling/DataFormat.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,mBAAmB,GAAyB;IACvD,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,SAAS;IACT;;;;OAIG;IACH,MAAM;IACN;;;;OAIG;IACH,UAAU;IACV,MAAM;IACN,SAAS;IACT,QAAQ;CACT,CAAA;AAED,MAAM,CAAN,IAAY,kBAUX;AAVD,WAAY,kBAAkB;IAC5B,uCAAiB,CAAA;IACjB,uCAAiB,CAAA;IACjB,eAAe;IACf,yCAAmB,CAAA;IACnB,mCAAa,CAAA;IACb,2CAAqB,CAAA;IACrB,mCAAa,CAAA;IACb,eAAe;IACf,qCAAe,CAAA;AACjB,CAAC,EAVW,kBAAkB,KAAlB,kBAAkB,QAU7B;AAgBD,MAAM,CAAC,MAAM,wBAAwB,GAA8B;IACjE,UAAU;IACV,UAAU;IACV,SAAS;IACT,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,WAAW;IACX,YAAY;CACb,CAAA;AAOD,MAAM,CAAC,MAAM,yBAAyB,GAA+B,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAa7F,MAAM,CAAC,MAAM,aAAa,GAAmB,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AAQlF,MAAM,CAAC,MAAM,aAAa,GAAmB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAA","sourcesContent":["export type DomainPropertyType =\n  | 'string'\n  | 'number'\n  // | 'nil'\n  | 'boolean'\n  | 'date'\n  | 'datetime'\n  | 'time'\n  // | 'any'\n  | 'binary'\n\nexport const DomainPropertyTypes: DomainPropertyType[] = [\n  'string',\n  'number',\n  // 'nil',\n  'boolean',\n  /**\n   * full-date notation as defined by RFC 3339, section 5.6, for example, 2017-07-21\n   *\n   * @see {@link https://tools.ietf.org/html/rfc3339#section-5.6}\n   */\n  'date',\n  /**\n   * the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z\n   *\n   * @see {@link https://tools.ietf.org/html/rfc3339#section-5.6}\n   */\n  'datetime',\n  'time',\n  // 'any',\n  'binary',\n]\n\nexport enum DomainPropertyList {\n  string = 'string',\n  number = 'number',\n  // nil = 'nil',\n  boolean = 'boolean',\n  date = 'date',\n  datetime = 'datetime',\n  time = 'time',\n  // any = 'any',\n  file = 'binary',\n}\n\n/**\n * The data property \"attributes\".\n */\nexport type DomainPropertyAttribute =\n  | 'required'\n  | 'multiple'\n  | 'primary'\n  | 'index'\n  | 'unique'\n  | 'search'\n  | 'readOnly'\n  | 'writeOnly'\n  | 'deprecated'\n\nexport const DomainPropertyAttributes: DomainPropertyAttribute[] = [\n  'required',\n  'multiple',\n  'primary',\n  'index',\n  'unique',\n  'search',\n  'readOnly',\n  'writeOnly',\n  'deprecated',\n]\n\n/**\n * The data attribute \"attributes\".\n */\nexport type DomainAttributeAttribute = 'required' | 'multiple'\n\nexport const DomainAttributeAttributes: DomainAttributeAttribute[] = ['required', 'multiple']\n\n/**\n * Note, OAS supports the `integer` data type and not format.\n * We need to account for that.\n *\n * - `float` - 32-bit floating point numbers\n * - `double` - 64-bit floating point numbers\n * - `int32` - Signed 32 bit number\n * - `int64` - Signed 64 bit number (OAS `long`)\n */\nexport type NumberFormat = 'float' | 'double' | 'int32' | 'int64'\n\nexport const NumberFormats: NumberFormat[] = ['float', 'double', 'int32', 'int64']\n\n/**\n * - `hex` - Hex-encoded binary data\n * - `base64` - Base64-encoded binary data\n */\nexport type BinaryFormat = 'hex' | 'base64'\n\nexport const BinaryFormats: BinaryFormat[] = ['hex', 'base64']\n\nexport type DomainPropertyFormat = NumberFormat | BinaryFormat\n"]}

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

@@ -246,6 +246,13 @@ export declare class DomainAssociation extends DomainElement {
      * ```
      */
     getWebBinding(): AssociationWebBindings;
+    /**
+     * Reads the web binding definition, if any.
+     * Useful for reading binding data without mutating the model when the binding
+     * is missing (unlike `getWebBinding()` which creates the binding when missing).
+     * @returns The web binding definition, if any
+     */
+    readWebBinding(): AssociationWebBindings | undefined;
     /**
      * Returns the schema value of the binding, if any was
      * created.

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

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

package/build/src/modeling/DomainAssociation.js

@@ -375,6 +375,16 @@ let DomainAssociation = (() => {
             }
             return object.schema;
         }
+        /**
+         * Reads the web binding definition, if any.
+         * Useful for reading binding data without mutating the model when the binding
+         * is missing (unlike `getWebBinding()` which creates the binding when missing).
+         * @returns The web binding definition, if any
+         */
+        readWebBinding() {
+            const object = this.bindings.find((i) => i.type === 'web');
+            return object?.schema;
+        }
         /**
          * Returns the schema value of the binding, if any was
          * created.

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

@@ -1 +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.js'\nimport { type ThingSchema, Thing } from '../models/Thing.js'\nimport { observed, retargetChange, toRaw } from '../decorators/observed.js'\nimport type { DomainEntity } from './DomainEntity.js'\nimport type { Shapes } from '@api-client/amf-core'\nimport type { AssociationBinding, AssociationBindings, AssociationWebBindings } from './Bindings.js'\nimport { DomainAttributeAttribute, DomainAttributeAttributes } from './DataFormat.js'\nimport type { AssociationTarget, DomainGraphEdge } from './types.js'\nimport { ShapeGenerator } from './amf/ShapeGenerator.js'\nimport { DataSemantics, isAssociationSemantic, type SemanticType, type AppliedDataSemantic } from './Semantics.js'\n\n/**\n * Defines the behavior when a parent entity in an association is deleted.\n *\n * - `restrict`: Prevents the deletion of a parent entity if it has any associated child entities.\n *               The generated API should return a clear and specific error message (e.g., 409 Conflict).\n *   - _Example_: Do not allow a Department to be deleted if it still has Employees.\n * - `cascade`: Automatically deletes all associated child entities when the parent entity is deleted.\n *   - _Example_: Deleting a User will also delete all their associated Posts and Comments.\n * - `setNull`: Sets the foreign key of the associated child entities to NULL. This is only valid if the\n *   association property on the child entity is nullable.\n *   - _Example_: When a `Project` is deleted, the `project_id` on associated `Tasks` is set to NULL,\n *   making them unassigned but not deleting them.\n * - `doNothing`: No action is taken on the associated child entities when the parent entity is deleted.\n *   - _Example_: Deleting a `Category` does not affect associated `Products`, which remain in the database\n *               but may become orphaned.\n *               This is useful when the association is optional or when child entities should not be deleted\n *               or modified upon the deletion of a parent entity.\n */\nexport type OnDeleteRule = 'restrict' | 'cascade' | 'setNull' | 'doNothing'\n\nexport interface DomainAssociationSchema extends DomainElementSchema {\n  kind: typeof DomainAssociationKind\n  /**\n   * The data association description.\n   */\n  info: ThingSchema\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?: Shapes.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   * The semantics applied to this association.\n   * This is a list of applied semantics that can be used to\n   * describe the association in more detail.\n   */\n  semantics?: AppliedDataSemantic[]\n  /**\n   * Defines the behavior when a parent entity in an association is deleted.\n   */\n  onDelete?: OnDeleteRule\n  /**\n   * Whether the association is read-only.\n   */\n  readOnly?: boolean\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: Shapes.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   * Semantics applied to this association.\n   */\n  @observed({ deep: true }) accessor semantics: AppliedDataSemantic[] = []\n\n  /**\n   * Defines the behavior when a parent entity in an association is deleted.\n   */\n  @observed() accessor onDelete: OnDeleteRule | undefined\n\n  /**\n   * Whether the association is read-only.\n   */\n  @observed() accessor readOnly: boolean | undefined\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(), semantics = [] } = 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 (Array.isArray(semantics)) {\n      result.semantics = [...semantics]\n    }\n    if (input.onDelete) {\n      result.onDelete = input.onDelete\n    }\n    if (typeof input.readOnly === 'boolean') {\n      result.readOnly = input.readOnly\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    if (Array.isArray(init.semantics)) {\n      this.semantics = init.semantics.map((item) => structuredClone(item))\n    } else {\n      this.semantics = []\n    }\n    if (init.onDelete) {\n      this.onDelete = init.onDelete\n    }\n    if (typeof init.readOnly === 'boolean') {\n      this.readOnly = init.readOnly\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 = structuredClone(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)?.map((i) => structuredClone(i))\n    }\n    if (Array.isArray(this.targets) && this.targets.length) {\n      result.targets = toRaw(this, this.targets)?.map((i) => ({ ...i }))\n    }\n    if (Array.isArray(this.semantics) && this.semantics.length) {\n      result.semantics = toRaw(this, this.semantics)?.map((i) => structuredClone(i))\n    }\n    if (this.onDelete) {\n      result.onDelete = this.onDelete\n    }\n    if (typeof this.readOnly === 'boolean' && this.readOnly) {\n      result.readOnly = this.readOnly\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(): Shapes.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(): Shapes.IApiPropertyShape {\n    const serializer = new ShapeGenerator()\n    return serializer.associationProperty(this)\n  }\n\n  /**\n   * Adds or updates a semantic to the association.\n   * @param semantic The semantic to add to the association.\n   * @throws Error if the semantic is not an association semantic.\n   */\n  addSemantic(semantic: AppliedDataSemantic): void {\n    const sem = DataSemantics[semantic.id]\n    if (!isAssociationSemantic(sem)) {\n      throw new Error(`Invalid semantic type: ${semantic.id}. Expected an association semantic.`)\n    }\n    const index = this.semantics.findIndex((s) => s.id === semantic.id)\n    if (index >= 0) {\n      this.semantics[index] = semantic\n    } else {\n      this.semantics.push(semantic)\n    }\n    this.domain.notifyChange()\n  }\n\n  /**\n   * Removes a semantic from the association.\n   * @param semanticId The ID of the semantic to remove.\n   */\n  removeSemantic(semanticId: SemanticType): void {\n    const index = this.semantics.findIndex((s) => s.id === semanticId)\n    if (index >= 0) {\n      this.semantics.splice(index, 1)\n      this.domain.notifyChange()\n    }\n  }\n\n  /**\n   * Checks if the association has a specific semantic.\n   * @param semanticId The ID of the semantic to check.\n   * @returns True if the semantic is present, false otherwise.\n   */\n  hasSemantic(semanticId: SemanticType): boolean {\n    return this.semantics.some((s) => s.id === semanticId)\n  }\n\n  /**\n   * Creates a duplicate of this association.\n   * It places the duplicate on the parent entity right after the original association.\n   *\n   * @returns A new `DomainAssociation` instance that is a duplicate of this one.\n   */\n  duplicate(): DomainAssociation {\n    const parent = this.getParentInstance()\n    if (!parent) {\n      throw new Error(`Cannot duplicate association ${this.key} as it has no parent entity.`)\n    }\n    const originalIndex = parent.fields.findIndex((f) => f.key === this.key)\n    if (originalIndex === -1) {\n      throw new Error(`Cannot duplicate association ${this.key} as it does not exist on the parent entity fields list.`)\n    }\n    const baseName = this.info.name || 'field'\n    const newName = parent.generateUniqueName(baseName)\n\n    // Making a copy and restoring it through the `addAssociation()` method\n    // scales better than copying it manually.\n    const copy = this.toJSON() as Partial<DomainAssociationSchema>\n\n    // Delete properties that should not be copied\n    delete copy.key\n    delete copy.targets\n\n    // Set the new name for the duplicated association\n    if (copy.info) {\n      copy.info.name = newName\n    } else {\n      copy.info = { name: newName }\n    }\n\n    const result = parent.addAssociation(copy)\n\n    // Copy the target entities\n    for (const target of this.targets) {\n      result.addTarget(target.key, target.domain)\n    }\n\n    // Move the duplicate to be right after the original\n    const fromIndex = parent.fields.length - 1\n    const duplicateField = parent.fields[fromIndex]\n    parent.fields.splice(fromIndex, 1)\n    parent.fields.splice(originalIndex + 1, 0, duplicateField)\n\n    this.domain.notifyChange()\n    return result\n  }\n}\n"]}
+{"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.js'\nimport { type ThingSchema, Thing } from '../models/Thing.js'\nimport { observed, retargetChange, toRaw } from '../decorators/observed.js'\nimport type { DomainEntity } from './DomainEntity.js'\nimport type { Shapes } from '@api-client/amf-core'\nimport type { AssociationBinding, AssociationBindings, AssociationWebBindings } from './Bindings.js'\nimport { DomainAttributeAttribute, DomainAttributeAttributes } from './DataFormat.js'\nimport type { AssociationTarget, DomainGraphEdge } from './types.js'\nimport { ShapeGenerator } from './amf/ShapeGenerator.js'\nimport { DataSemantics, isAssociationSemantic, type SemanticType, type AppliedDataSemantic } from './Semantics.js'\n\n/**\n * Defines the behavior when a parent entity in an association is deleted.\n *\n * - `restrict`: Prevents the deletion of a parent entity if it has any associated child entities.\n *               The generated API should return a clear and specific error message (e.g., 409 Conflict).\n *   - _Example_: Do not allow a Department to be deleted if it still has Employees.\n * - `cascade`: Automatically deletes all associated child entities when the parent entity is deleted.\n *   - _Example_: Deleting a User will also delete all their associated Posts and Comments.\n * - `setNull`: Sets the foreign key of the associated child entities to NULL. This is only valid if the\n *   association property on the child entity is nullable.\n *   - _Example_: When a `Project` is deleted, the `project_id` on associated `Tasks` is set to NULL,\n *   making them unassigned but not deleting them.\n * - `doNothing`: No action is taken on the associated child entities when the parent entity is deleted.\n *   - _Example_: Deleting a `Category` does not affect associated `Products`, which remain in the database\n *               but may become orphaned.\n *               This is useful when the association is optional or when child entities should not be deleted\n *               or modified upon the deletion of a parent entity.\n */\nexport type OnDeleteRule = 'restrict' | 'cascade' | 'setNull' | 'doNothing'\n\nexport interface DomainAssociationSchema extends DomainElementSchema {\n  kind: typeof DomainAssociationKind\n  /**\n   * The data association description.\n   */\n  info: ThingSchema\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?: Shapes.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   * The semantics applied to this association.\n   * This is a list of applied semantics that can be used to\n   * describe the association in more detail.\n   */\n  semantics?: AppliedDataSemantic[]\n  /**\n   * Defines the behavior when a parent entity in an association is deleted.\n   */\n  onDelete?: OnDeleteRule\n  /**\n   * Whether the association is read-only.\n   */\n  readOnly?: boolean\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: Shapes.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   * Semantics applied to this association.\n   */\n  @observed({ deep: true }) accessor semantics: AppliedDataSemantic[] = []\n\n  /**\n   * Defines the behavior when a parent entity in an association is deleted.\n   */\n  @observed() accessor onDelete: OnDeleteRule | undefined\n\n  /**\n   * Whether the association is read-only.\n   */\n  @observed() accessor readOnly: boolean | undefined\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(), semantics = [] } = 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 (Array.isArray(semantics)) {\n      result.semantics = [...semantics]\n    }\n    if (input.onDelete) {\n      result.onDelete = input.onDelete\n    }\n    if (typeof input.readOnly === 'boolean') {\n      result.readOnly = input.readOnly\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    if (Array.isArray(init.semantics)) {\n      this.semantics = init.semantics.map((item) => structuredClone(item))\n    } else {\n      this.semantics = []\n    }\n    if (init.onDelete) {\n      this.onDelete = init.onDelete\n    }\n    if (typeof init.readOnly === 'boolean') {\n      this.readOnly = init.readOnly\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 = structuredClone(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)?.map((i) => structuredClone(i))\n    }\n    if (Array.isArray(this.targets) && this.targets.length) {\n      result.targets = toRaw(this, this.targets)?.map((i) => ({ ...i }))\n    }\n    if (Array.isArray(this.semantics) && this.semantics.length) {\n      result.semantics = toRaw(this, this.semantics)?.map((i) => structuredClone(i))\n    }\n    if (this.onDelete) {\n      result.onDelete = this.onDelete\n    }\n    if (typeof this.readOnly === 'boolean' && this.readOnly) {\n      result.readOnly = this.readOnly\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(): Shapes.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   * Reads the web binding definition, if any.\n   * Useful for reading binding data without mutating the model when the binding\n   * is missing (unlike `getWebBinding()` which creates the binding when missing).\n   * @returns The web binding definition, if any\n   */\n  readWebBinding(): AssociationWebBindings | undefined {\n    const object = this.bindings.find((i) => i.type === 'web') as AssociationBinding | undefined\n    return object?.schema as AssociationWebBindings | undefined\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(): Shapes.IApiPropertyShape {\n    const serializer = new ShapeGenerator()\n    return serializer.associationProperty(this)\n  }\n\n  /**\n   * Adds or updates a semantic to the association.\n   * @param semantic The semantic to add to the association.\n   * @throws Error if the semantic is not an association semantic.\n   */\n  addSemantic(semantic: AppliedDataSemantic): void {\n    const sem = DataSemantics[semantic.id]\n    if (!isAssociationSemantic(sem)) {\n      throw new Error(`Invalid semantic type: ${semantic.id}. Expected an association semantic.`)\n    }\n    const index = this.semantics.findIndex((s) => s.id === semantic.id)\n    if (index >= 0) {\n      this.semantics[index] = semantic\n    } else {\n      this.semantics.push(semantic)\n    }\n    this.domain.notifyChange()\n  }\n\n  /**\n   * Removes a semantic from the association.\n   * @param semanticId The ID of the semantic to remove.\n   */\n  removeSemantic(semanticId: SemanticType): void {\n    const index = this.semantics.findIndex((s) => s.id === semanticId)\n    if (index >= 0) {\n      this.semantics.splice(index, 1)\n      this.domain.notifyChange()\n    }\n  }\n\n  /**\n   * Checks if the association has a specific semantic.\n   * @param semanticId The ID of the semantic to check.\n   * @returns True if the semantic is present, false otherwise.\n   */\n  hasSemantic(semanticId: SemanticType): boolean {\n    return this.semantics.some((s) => s.id === semanticId)\n  }\n\n  /**\n   * Creates a duplicate of this association.\n   * It places the duplicate on the parent entity right after the original association.\n   *\n   * @returns A new `DomainAssociation` instance that is a duplicate of this one.\n   */\n  duplicate(): DomainAssociation {\n    const parent = this.getParentInstance()\n    if (!parent) {\n      throw new Error(`Cannot duplicate association ${this.key} as it has no parent entity.`)\n    }\n    const originalIndex = parent.fields.findIndex((f) => f.key === this.key)\n    if (originalIndex === -1) {\n      throw new Error(`Cannot duplicate association ${this.key} as it does not exist on the parent entity fields list.`)\n    }\n    const baseName = this.info.name || 'field'\n    const newName = parent.generateUniqueName(baseName)\n\n    // Making a copy and restoring it through the `addAssociation()` method\n    // scales better than copying it manually.\n    const copy = this.toJSON() as Partial<DomainAssociationSchema>\n\n    // Delete properties that should not be copied\n    delete copy.key\n    delete copy.targets\n\n    // Set the new name for the duplicated association\n    if (copy.info) {\n      copy.info.name = newName\n    } else {\n      copy.info = { name: newName }\n    }\n\n    const result = parent.addAssociation(copy)\n\n    // Copy the target entities\n    for (const target of this.targets) {\n      result.addTarget(target.key, target.domain)\n    }\n\n    // Move the duplicate to be right after the original\n    const fromIndex = parent.fields.length - 1\n    const duplicateField = parent.fields[fromIndex]\n    parent.fields.splice(fromIndex, 1)\n    parent.fields.splice(originalIndex + 1, 0, duplicateField)\n\n    this.domain.notifyChange()\n    return result\n  }\n}\n"]}

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

@@ -232,7 +232,7 @@ export declare class DomainEntity extends DomainElement {
      */
     get parents(): Generator<DomainEntity>;
     /**
-     * Lists all parent entities of this entity.
+     * Lists all parent entities of this entity (only the first level).
      *
      * @returns A generator that yields each parent `DomainEntity`.
      * @example
@@ -243,6 +243,14 @@ export declare class DomainEntity extends DomainElement {
      * ```
      */
     listParents(): Generator<DomainEntity>;
+    /**
+     * Lists all parent entities recursively.
+     *
+     * @param direction The direction of the traversal. 'up' (default) lists from immediate parents up to the oldest.
+     *                  'down' lists from the oldest parents down to the immediate parents.
+     * @returns An array of parent `DomainEntity` instances, ordered according to the requested traversal direction.
+     */
+    listAllParents(direction?: 'up' | 'down'): DomainEntity[];
     /**
      * Adds a parent to this entity.
      *

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

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

package/build/src/modeling/DomainEntity.js

@@ -355,7 +355,7 @@ let DomainEntity = (() => {
             return this.listParents();
         }
         /**
-         * Lists all parent entities of this entity.
+         * Lists all parent entities of this entity (only the first level).
          *
          * @returns A generator that yields each parent `DomainEntity`.
          * @example
@@ -377,6 +377,31 @@ let DomainEntity = (() => {
                 }
             }
         }
+        /**
+         * Lists all parent entities recursively.
+         *
+         * @param direction The direction of the traversal. 'up' (default) lists from immediate parents up to the oldest.
+         *                  'down' lists from the oldest parents down to the immediate parents.
+         * @returns An array of parent `DomainEntity` instances, ordered according to the requested traversal direction.
+         */
+        listAllParents(direction = 'up') {
+            const visited = new Set();
+            const parents = [];
+            const queue = [...this.listParents()];
+            let index = 0;
+            while (index < queue.length) {
+                const parent = queue[index++];
+                if (!visited.has(parent.key)) {
+                    visited.add(parent.key);
+                    parents.push(parent);
+                    queue.push(...parent.listParents());
+                }
+            }
+            if (direction === 'down') {
+                parents.reverse();
+            }
+            return parents;
+        }
         /**
          * Adds a parent to this entity.
          *