@api-client/core 0.18.17 → 0.18.19

package/build/src/{modeling → decorators}/observed.d.ts

@@ -48,10 +48,10 @@ export declare function toRaw<T extends object = object>(source: object, target:
  * - As a class property decorator
  * - As a class setter decorator
  *
- * The property class either has to have a `root` property
+ * The property class either has to have the `domain` property
  * or a `notifyChange` method. The decorator will call the
  * `notifyChange` method if it exists. Otherwise, it will
- * call the `notifyChange` method of the root domain.
+ * call the `notifyChange` method of the root domain (the `domain` property).
  */
 export declare function observed(config?: ObserveConfig): PropertyDecorator;
 /**
@@ -62,6 +62,6 @@ export declare function observed(config?: ObserveConfig): PropertyDecorator;
  * It does the same thing. It will notify about a change to the
  * property itself.
  */
-export declare function retargetChange(): <C extends DomainInstance, V extends EventTarget>(target: StandardPropertyTarget<C, V>, context: StandardPropertyContext<C, V>) => any;
+export declare function retargetChange(): <C extends DomainInstance, V extends EventTarget | undefined>(target: StandardPropertyTarget<C, V>, context: StandardPropertyContext<C, V>) => any;
 export {};
 //# sourceMappingURL=observed.d.ts.map

package/build/src/decorators/observed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed.d.ts","sourceRoot":"","sources":["../../../src/decorators/observed.ts"],"names":[],"mappings":"AAIA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE;QAAE,YAAY,IAAI,IAAI,CAAA;KAAE,CAAA;IACjC,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAEhC,CAAC,CAAC,SAAS,cAAc,EAAE,CAAC,EAC1B,MAAM,EAAE,4BAA4B,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1C,OAAO,EAAE,6BAA6B,CAAC,CAAC,EAAE,CAAC,CAAC,GAC3C,4BAA4B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAErC,CAAC,CAAC,SAAS,cAAc,EAAE,CAAC,EAC1B,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC1B,OAAO,EAAE,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,GACzC,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAA;CAC/B;AAED,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,6BAA6B,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,2BAA2B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC5G,KAAK,sBAAsB,CAAC,CAAC,EAAE,CAAC,IAAI,4BAA4B,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,CAAA;AAE7F,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAUzF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,QAAQ,CAAC,MAAM,GAAE,aAAkB,GAAG,iBAAiB,CA2GtE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,KACpB,CAAC,SAAS,cAAc,EAAE,CAAC,SAAS,WAAW,GAAG,SAAS,EACjE,QAAQ,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,EACpC,SAAS,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC,KACrC,GAAG,CAiEP"}

package/build/src/{modeling → decorators}/observed.js

@@ -42,10 +42,10 @@ export function toRaw(source, target) {
  * - As a class property decorator
  * - As a class setter decorator
  *
- * The property class either has to have a `root` property
+ * The property class either has to have the `domain` property
  * or a `notifyChange` method. The decorator will call the
  * `notifyChange` method if it exists. Otherwise, it will
- * call the `notifyChange` method of the root domain.
+ * call the `notifyChange` method of the root domain (the `domain` property).
  */
 export function observed(config = {}) {
     return (target, context) => {
@@ -99,7 +99,7 @@ export function observed(config = {}) {
                         map = {};
                         Reflect.set(this, reactiveSymbol, map);
                     }
-                    if (map[context.name] === context.name) {
+                    if (map[context.name] === value) {
                         return;
                     }
                     const notify = () => {
@@ -175,7 +175,7 @@ export function retargetChange() {
                         map = {};
                         Reflect.set(this, reactiveSymbol, map);
                     }
-                    if (map[context.name] === context.name) {
+                    if (map[context.name] === value) {
                         return;
                     }
                     const oldValue = map[context.name];

package/build/src/decorators/observed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observed.js","sourceRoot":"","sources":["../../../src/decorators/observed.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nconst reactiveSymbol = Symbol('reactive')\nconst proxySymbol = Symbol('proxy')\n\ninterface DomainInstance {\n  domain?: { notifyChange(): void }\n  notifyChange?: () => void\n}\n\nexport interface PropertyDecorator {\n  // accessor decorator signature\n  <C extends DomainInstance, V>(\n    target: ClassAccessorDecoratorTarget<C, V>,\n    context: ClassAccessorDecoratorContext<C, V>\n  ): ClassAccessorDecoratorResult<C, V>\n  // setter decorator signature\n  <C extends DomainInstance, V>(\n    target: (value: V) => void,\n    context: ClassSetterDecoratorContext<C, V>\n  ): (this: C, value: V) => void\n}\n\ntype StandardPropertyContext<C, V> = ClassAccessorDecoratorContext<C, V> | ClassSetterDecoratorContext<C, V>\ntype StandardPropertyTarget<C, V> = ClassAccessorDecoratorTarget<C, V> | ((value: V) => void)\n\nexport interface ObserveConfig {\n  /**\n   * To be used when observing an object and not a primitive.\n   * It creates a proxy that observes changes in the object.\n   */\n  deep?: boolean\n}\n\n/**\n * Reads the raw value of the object, that is, not proxied object.\n * @param source The source object that contains the object\n * @param target The target object set on the source object\n * @returns The not proxied object or undefined\n */\nexport function toRaw<T extends object = object>(source: object, target: T): T | undefined {\n  const proxies = Reflect.get(source, proxySymbol) as Map<object, object>\n  if (!proxies) {\n    return undefined\n  }\n  for (const [key, value] of proxies.entries()) {\n    if (value === target) {\n      return key as T\n    }\n  }\n}\n\n/**\n * Turns a class property or a setter into an observed property\n * that notifies the root domain when changed.\n *\n * A property has to be declared with the `accessor` type to be\n * observed.\n *\n * ```typescript\n * @observed() accessor name: string | undefined\n *\n * @observed()\n * set height(value: number) {\n *   this.#height = value\n * }\n *\n * get height(): number {\n *   return this.#height\n * }\n * ```\n *\n * The decorator can be used in the following ways:\n * - As a class property decorator\n * - As a class setter decorator\n *\n * The property class either has to have the `domain` property\n * or a `notifyChange` method. The decorator will call the\n * `notifyChange` method if it exists. Otherwise, it will\n * call the `notifyChange` method of the root domain (the `domain` property).\n */\nexport function observed(config: ObserveConfig = {}): PropertyDecorator {\n  return <C extends DomainInstance, V>(\n    target: StandardPropertyTarget<C, V>,\n    context: StandardPropertyContext<C, V>\n  ): any => {\n    const { kind } = context\n    const { deep } = config\n\n    function createDeepProxy(this: DomainInstance, obj: unknown, notifyChange: () => void): any {\n      if (typeof obj !== 'object' || obj === null) {\n        return obj\n      }\n      // instead of using the target object to store the proxy info, we\n      // reflect the proxy info to the object itself. This way we can\n      // keep the stored values clean, which helps with testing (deep equal would include symbols)\n      // Keys are original objects, values are proxies\n      let proxies = Reflect.get(this, proxySymbol) as Map<object, object>\n      if (!proxies) {\n        proxies = new Map()\n        Reflect.set(this, proxySymbol, proxies)\n      }\n\n      if (proxies.has(obj)) {\n        return obj\n      }\n\n      // eslint-disable-next-line @typescript-eslint/no-this-alias\n      const targetObject = this\n\n      const proxy = new Proxy(obj, {\n        get(target, prop) {\n          const value = Reflect.get(target, prop)\n          return createDeepProxy.bind(targetObject)(value, notifyChange)\n        },\n        set(target, prop, value) {\n          const oldValue = Reflect.get(target, prop)\n          if (oldValue !== value) {\n            Reflect.set(target, prop, value)\n            notifyChange()\n          }\n          return true\n        },\n        deleteProperty(target, prop) {\n          Reflect.deleteProperty(target, prop)\n          notifyChange()\n          return true\n        },\n      })\n      proxies.set(obj, proxy)\n      return proxy\n    }\n\n    if (kind === 'accessor') {\n      return {\n        set(this: DomainInstance, value: V): void {\n          let map = Reflect.get(this, reactiveSymbol)\n          if (!map) {\n            map = {}\n            Reflect.set(this, reactiveSymbol, map)\n          }\n          if (map[context.name] === value) {\n            return\n          }\n          const notify = () => {\n            if (this.domain) {\n              this.domain.notifyChange()\n            } else if (this.notifyChange) {\n              this.notifyChange()\n            }\n          }\n          if (deep) {\n            value = createDeepProxy.bind(this)(value, notify)\n          }\n          if (value === undefined) {\n            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n            delete map[context.name]\n          } else {\n            map[context.name] = value\n          }\n          notify()\n        },\n\n        get(): V {\n          const map = Reflect.get(this, reactiveSymbol) || {}\n          return map[context.name]\n        },\n      }\n    } else if (kind === 'setter') {\n      const { name } = context\n      return function (this: DomainInstance, value: V): void {\n        const oldValue = this[name as keyof DomainInstance]\n        if (value === oldValue) {\n          return\n        }\n        const notify = () => {\n          if (this.domain) {\n            this.domain.notifyChange()\n          } else if (this.notifyChange) {\n            this.notifyChange()\n          }\n        }\n        ;(target as (value: V) => void).call(this, value)\n        notify()\n      }\n    }\n    throw new Error(`Unsupported decorator location: ${kind}`)\n  }\n}\n\n/**\n * A decorator that can be used to retarget the change event\n * of a property to the root domain.\n *\n * This decorator should not be used with the `observed` decorator.\n * It does the same thing. It will notify about a change to the\n * property itself.\n */\nexport function retargetChange() {\n  return <C extends DomainInstance, V extends EventTarget | undefined>(\n    target: StandardPropertyTarget<C, V>,\n    context: StandardPropertyContext<C, V>\n  ): any => {\n    const { kind } = context\n    function observer(this: DomainInstance) {\n      if (this.domain) {\n        this.domain.notifyChange()\n      }\n    }\n    let binding: ((this: DomainInstance) => void) | undefined\n    if (kind === 'accessor') {\n      return {\n        set(this: DomainInstance, value: V): void {\n          let map = Reflect.get(this, reactiveSymbol)\n          if (!map) {\n            map = {}\n            Reflect.set(this, reactiveSymbol, map)\n          }\n          if (map[context.name] === value) {\n            return\n          }\n          const oldValue = map[context.name]\n          if (oldValue === value) {\n            return\n          }\n          if (value === undefined) {\n            // eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n            delete map[context.name]\n          } else {\n            map[context.name] = value\n          }\n          if (oldValue && binding) {\n            oldValue.removeEventListener('change', binding)\n          }\n          if (value) {\n            binding = observer.bind(this)\n            value.addEventListener('change', binding)\n          }\n          if (this.domain) {\n            this.domain.notifyChange()\n          }\n        },\n\n        get(): V {\n          const map = Reflect.get(this, reactiveSymbol) || {}\n          return map[context.name]\n        },\n      }\n    } else if (kind === 'setter') {\n      const { name } = context\n      return function (this: DomainInstance, value: V): void {\n        const oldValue = this[name as keyof DomainInstance] as unknown as V\n        if (value === oldValue) {\n          return\n        }\n        ;(target as (value: V) => void).call(this, value)\n        if (oldValue && binding) {\n          oldValue.removeEventListener('change', binding)\n        }\n        if (value) {\n          binding = observer.bind(this)\n          value.addEventListener('change', binding)\n        }\n      }\n    }\n    throw new Error(`Unsupported decorator location: ${kind}`)\n  }\n}\n"]}

package/build/src/modeling/ApiModel.js

@@ -4,7 +4,7 @@ import { ApiModelKind, DataDomainKind } from '../models/kinds.js';
 import { Thing } from '../models/Thing.js';
 import { DataDomain } from './DataDomain.js';
 import { DependentModel } from './DependentModel.js';
-import { observed, toRaw } from './observed.js';
+import { observed, toRaw } from '../decorators/observed.js';
 let ApiModel = (() => {
     let _classSuper = DependentModel;
     let _termsOfService_decorators;

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

@@ -1 +1 @@
-{"version":3,"file":"ApiModel.js","sourceRoot":"","sources":["../../../src/modeling/ApiModel.ts"],"names":[],"mappings":"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","sourcesContent":["import { nanoid } from '../nanoid.js'\nimport { ApiModelKind, DataDomainKind } from '../models/kinds.js'\nimport { type IThing, Thing } from '../models/Thing.js'\nimport type {\n  AccessRule,\n  AssociationTarget,\n  AuthenticationConfiguration,\n  AuthorizationConfiguration,\n  ExposedEntity,\n  RateLimitingConfiguration,\n  RolesBasedAccessControl,\n  SessionConfiguration,\n  UsernamePasswordConfiguration,\n} from './types.js'\nimport { DataDomain } from './DataDomain.js'\nimport { DependentModel, type DependentModelSchema, type DomainDependency } from './DependentModel.js'\nimport { observed, toRaw } from './observed.js'\n\n/**\n * Contact information for the exposed API.\n */\nexport interface ApiContact {\n  /**\n   * The identifying name of the contact person/organization.\n   */\n  name?: string\n  /**\n   * The URL pointing to the contact information. MUST be in the format of a URL.\n   */\n  url?: string\n  /**\n   * The email address of the contact person/organization. MUST be in the format of an email address.\n   */\n  email?: string\n}\n\n/**\n * License information for the exposed API.\n */\nexport interface ApiLicense {\n  /**\n   * The license name used for the API. It is recommended to be an SPDX license identifier.\n   */\n  name: string\n  /**\n   * A URL to the license used for the API. MUST be in the format of a URL.\n   */\n  url?: string\n}\n\nexport interface ApiModelSchema extends DependentModelSchema {\n  /**\n   * The data domain kind recognizable by the ecosystem.\n   */\n  kind: typeof ApiModelKind\n  /**\n   * The unique key of the data domain schema.\n   * This is a stable identifier that does not change across versions.\n   */\n  key: string\n  /**\n   * Contains the name, display name, description, and the version of the data domain schema.\n   */\n  info: IThing\n\n  /**\n   * The designated Data Entity that represents a \"User\".\n   * This entity should be marked with the \"User\" semantic in the Data Modeler.\n   *\n   * This property is required to publish the API.\n   */\n  user?: AssociationTarget\n\n  /**\n   * Configuration for how users prove their identity.\n   * The API model is invalid if this is not set.\n   */\n  authentication?: AuthenticationConfiguration\n\n  /**\n   * Configuration for what authenticated users are allowed to do.\n   * The API model is invalid if this is not set.\n   */\n  authorization?: AuthorizationConfiguration\n\n  /**\n   * Configuration for the transport and payload of the user session.\n   * The API model is invalid if this is not set.\n   */\n  session?: SessionConfiguration\n  /**\n   * The specific subset of Data Entities to be exposed by this API.\n   * These are the entities that are included in the data domain schema.\n   */\n  exposes: ExposedEntity[]\n\n  /**\n   * Optional array of access rules that define the access control policies\n   * for the API. These rules are used to enforce security and permissions\n   * on the exposed entities.\n   *\n   * These rules apply to all exposed entities and actions. An API action\n   * can declare its own access rules, which will override these.\n   */\n  accessRule?: AccessRule[]\n  /**\n   * Optional configuration for API-wide rate limiting and throttling.\n   * Defines rules to protect the API from overuse.\n   */\n  rateLimiting?: RateLimitingConfiguration\n  /**\n   * A URL to the Terms of Service for the API.\n   */\n  termsOfService?: string\n  /**\n   * The contact information for the exposed API.\n   */\n  contact?: ApiContact\n  /**\n   * The license information for the API.\n   */\n  license?: ApiLicense\n}\n\nexport class ApiModel extends DependentModel {\n  /**\n   * The data domain kind recognizable by the ecosystem.\n   */\n  kind: typeof ApiModelKind\n  /**\n   * The unique key of the data domain schema.\n   * This is a stable identifier that does not change across versions.\n   */\n  key: string\n\n  /**\n   * The description of the domain property.\n   */\n  info: Thing\n  /**\n   * The designated Data Entity that represents a \"User\".\n   * This entity must be marked with the \"User\" semantic in the Data Modeler.\n   *\n   * This property is required to publish the API.\n   */\n  user?: AssociationTarget\n\n  /**\n   * Configuration for how users prove their identity.\n   * The API model is invalid if this is not set.\n   */\n  authentication?: AuthenticationConfiguration\n\n  /**\n   * Configuration for what authenticated users are allowed to do.\n   * The API model is invalid if this is not set.\n   */\n  authorization?: AuthorizationConfiguration\n\n  /**\n   * Configuration for the transport and payload of the user session.\n   * The API model is invalid if this is not set.\n   */\n  session?: SessionConfiguration\n  /**\n   * The specific subset of Data Entities to be exposed by this API.\n   * These are the entities that are included in the data domain schema.\n   */\n  exposes: ExposedEntity[]\n  /**\n   * Optional array of access rules that define the access control policies\n   * for the API. These rules are used to enforce security and permissions\n   * on the exposed entities.\n   *\n   * These rules apply to all exposed entities and actions. An API action\n   * can declare its own access rules, which will override these.\n   */\n  accessRule?: AccessRule[]\n  /**\n   * Optional configuration for API-wide rate limiting and throttling.\n   * Defines rules to protect the API from overuse.\n   */\n  rateLimiting?: RateLimitingConfiguration\n  /**\n   * A URL to the Terms of Service for the API.\n   */\n  @observed() accessor termsOfService: string | undefined\n  /**\n   * The contact information for the exposed API.\n   */\n  @observed({ deep: true }) accessor contact: ApiContact | undefined\n  /**\n   * The license information for the API.\n   */\n  @observed({ deep: true }) accessor license: ApiLicense | undefined\n\n  /**\n   * When the initializing flag is set to true,\n   * the domain is not notified of changes.\n   */\n  #initializing = true\n\n  /**\n   * When the notifying flag is set to true,\n   * the domain is pending a notification.\n   * No other notifications will be sent until\n   * the current notification is sent.\n   */\n  #notifying = false\n\n  /**\n   * A convenience getter that returns the DataDomain associated with this API model.\n   * Since the API model can have only one DataDomain,\n   * this getter returns the first dependency in the list.\n   *\n   * The parent interface `DependentModel` allows for multiple dependencies,\n   * to unify the dependency management across different models.\n   */\n  get domain(): DataDomain | undefined {\n    if (this.dependencyList.length === 0) {\n      return undefined\n    }\n    const domain = this.dependencyList[0]\n    return this.dependencies.get(domain.key)\n  }\n\n  static createSchema(input: Partial<ApiModelSchema> = {}): ApiModelSchema {\n    const { key = nanoid(), exposes = [] } = input\n    const info = Thing.fromJSON(input.info, { name: 'Unnamed API' }).toJSON()\n    const result: ApiModelSchema = {\n      kind: ApiModelKind,\n      key,\n      info,\n      exposes,\n    }\n    if (input.user) {\n      result.user = { ...input.user }\n    }\n    if (input.dependencyList) {\n      result.dependencyList = structuredClone(input.dependencyList)\n    }\n    if (input.authentication) {\n      result.authentication = input.authentication\n    }\n    if (input.authorization) {\n      result.authorization = input.authorization\n    }\n    if (input.session) {\n      result.session = input.session\n    }\n    if (input.accessRule) {\n      result.accessRule = input.accessRule\n    }\n    if (input.rateLimiting) {\n      result.rateLimiting = input.rateLimiting\n    }\n    if (input.termsOfService) {\n      result.termsOfService = input.termsOfService\n    }\n    if (input.contact) {\n      result.contact = structuredClone(input.contact)\n    }\n    if (input.license) {\n      result.license = structuredClone(input.license)\n    }\n    return result\n  }\n\n  constructor(state?: Partial<ApiModelSchema>, domain?: DomainDependency) {\n    const init = ApiModel.createSchema(state)\n    const instances: DataDomain[] = []\n    if (domain instanceof DataDomain) {\n      instances.push(domain)\n    } else if (typeof domain === 'object' && domain.kind === DataDomainKind) {\n      instances.push(new DataDomain(domain))\n    } else if (domain) {\n      throw new Error(`Invalid domain provided. Expected a DataDomain instance or schema.`)\n    }\n    super(init.dependencyList, instances)\n    this.kind = init.kind\n    this.key = init.key\n    this.info = new Thing(init.info)\n    this.user = init.user\n    if (init.authentication) {\n      this.authentication = structuredClone(init.authentication)\n    }\n    if (init.authorization) {\n      this.authorization = structuredClone(init.authorization)\n    }\n    if (init.session) {\n      this.session = structuredClone(init.session)\n    }\n    if (Array.isArray(init.exposes)) {\n      this.exposes = structuredClone(init.exposes)\n    } else {\n      this.exposes = []\n    }\n    if (init.accessRule) {\n      this.accessRule = structuredClone(init.accessRule)\n    }\n    if (init.rateLimiting) {\n      this.rateLimiting = structuredClone(init.rateLimiting)\n    }\n    if (init.termsOfService) {\n      this.termsOfService = init.termsOfService\n    }\n    if (init.contact) {\n      this.contact = init.contact\n    }\n    if (init.license) {\n      this.license = init.license\n    }\n    this.#initializing = false\n    this.info.addEventListener('change', () => {\n      this.notifyChange()\n    })\n  }\n\n  toJSON(): ApiModelSchema {\n    const result: ApiModelSchema = {\n      kind: this.kind,\n      key: this.key,\n      info: this.info.toJSON(),\n      exposes: structuredClone(this.exposes),\n    }\n    if (this.user) {\n      result.user = { ...this.user }\n    }\n    if (this.dependencyList.length > 0) {\n      result.dependencyList = structuredClone(this.dependencyList)\n    }\n    if (this.authentication) {\n      result.authentication = structuredClone(this.authentication)\n    }\n    if (this.authorization) {\n      result.authorization = structuredClone(this.authorization)\n    }\n    if (this.session) {\n      result.session = structuredClone(this.session)\n    }\n    if (this.accessRule) {\n      result.accessRule = structuredClone(this.accessRule)\n    }\n    if (this.rateLimiting) {\n      result.rateLimiting = structuredClone(this.rateLimiting)\n    }\n    if (this.termsOfService) {\n      result.termsOfService = this.termsOfService\n    }\n    if (this.contact) {\n      result.contact = structuredClone(toRaw(this, this.contact))\n    }\n    if (this.license) {\n      result.license = structuredClone(toRaw(this, this.license))\n    }\n    return result\n  }\n\n  /**\n   * This function is used internally by all domain elements to notify that something has changed.\n   * Since we want to notify listeners after the operation commits, we use microtask\n   * to ensure that the event is dispatched after the current operation.\n   */\n  notifyChange() {\n    if (this.#notifying || this.#initializing) {\n      return\n    }\n    this.#notifying = true\n    queueMicrotask(() => {\n      this.#notifying = false\n      const event = new Event('change')\n      this.dispatchEvent(event)\n    })\n  }\n\n  /**\n   * Exposes a new entity in the API model.\n   * If the entity already exists, it returns the existing one.\n   * @param entityKey The key of the entity to expose.\n   * @returns The exposed entity.\n   */\n  exposeEntity(entityKey: string): ExposedEntity {\n    const existing = this.exposes.find((e) => e.key === entityKey)\n    if (existing) {\n      return existing\n    }\n    const newEntity: ExposedEntity = {\n      key: entityKey,\n      actions: [],\n    }\n    this.exposes.push(newEntity)\n    this.notifyChange()\n    return newEntity\n  }\n\n  /**\n   * Removes an entity from the API model.\n   * @param entityKey The key of the entity to remove.\n   */\n  removeEntity(entityKey: string): void {\n    const index = this.exposes.findIndex((e) => e.key === entityKey)\n    if (index !== -1) {\n      this.exposes.splice(index, 1)\n      this.notifyChange()\n    }\n  }\n  /**\n   * Returns the exposed entity by its key.\n   * @param entityKey The key of the entity to find.\n   * @returns The exposed entity or undefined if not found.\n   */\n  getExposedEntity(entityKey: string): ExposedEntity | undefined {\n    return this.exposes.find((e) => e.key === entityKey)\n  }\n\n  /**\n   * Clears the API model for a new entity change.\n   * This method resets the dependencies, exposes, user,\n   * authentication, authorization, and session properties.\n   */\n  cleanForEntityChange(): void {\n    this.dependencies.clear()\n    this.dependencyList = []\n    this.exposes = []\n    this.user = undefined\n    if (this.session) {\n      this.session.properties = []\n    }\n    if (this.authentication && this.authentication.strategy === 'UsernamePassword') {\n      const typed = this.authentication as UsernamePasswordConfiguration\n      typed.passwordKey = undefined\n    }\n    if (this.authorization && this.authorization.strategy == 'RBAC') {\n      const typed = this.authorization as RolesBasedAccessControl\n      typed.roleKey = ''\n    }\n  }\n\n  /**\n   * Attaches a DataDomain to this API model.\n   * This method clears any existing dependencies and sets the new domain.\n   *\n   * @param domain The DataDomain to attach to this API model.\n   * @throws Error if the domain does not have a version set in its info.\n   */\n  attachDataDomain(domain: DataDomain): void {\n    if (!domain.info.version) {\n      throw new Error(`Cannot attach DataDomain without a version. Please set the version in the domain info.`)\n    }\n    this.cleanForEntityChange()\n    this.dependencies.set(domain.key, domain)\n    this.dependencyList = [{ key: domain.key, version: domain.info.version }]\n    this.notifyChange()\n  }\n}\n"]}
+{"version":3,"file":"ApiModel.js","sourceRoot":"","sources":["../../../src/modeling/ApiModel.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAe,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAYvD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAoD,MAAM,qBAAqB,CAAA;AACtG,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAA;IA4G9C,QAAQ;sBAAS,cAAc;;;;;;;;;;iBAA/B,QAAS,SAAQ,WAAc;;;0CA8DzC,QAAQ,EAAE;mCAIV,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;mCAIxB,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YARb,+LAAS,cAAc,6BAAd,cAAc,uGAAoB;YAI7B,0KAAS,OAAO,6BAAP,OAAO,yFAAwB;YAIxC,0KAAS,OAAO,6BAAP,OAAO,yFAAwB;;;QArElE;;WAEG;QACH,IAAI,CAAqB;QACzB;;;WAGG;QACH,GAAG,CAAQ;QAEX;;WAEG;QACH,IAAI,CAAO;QACX;;;;;WAKG;QACH,IAAI,CAAoB;QAExB;;;WAGG;QACH,cAAc,CAA8B;QAE5C;;;WAGG;QACH,aAAa,CAA6B;QAE1C;;;WAGG;QACH,OAAO,CAAuB;QAC9B;;;WAGG;QACH,OAAO,CAAiB;QACxB;;;;;;;WAOG;QACH,UAAU,CAAe;QACzB;;;WAGG;QACH,YAAY,CAA4B;QAI5B,iGAA2C;QAHvD;;WAEG;QACS,IAAS,cAAc,oDAAoB;QAA3C,IAAS,cAAc,0DAAoB;QAI7B,iJAAwC;QAHlE;;WAEG;QACuB,IAAS,OAAO,6CAAwB;QAAxC,IAAS,OAAO,mDAAwB;QAIxC,0IAAwC;QAHlE;;WAEG;QACuB,IAAS,OAAO,6CAAwB;QAAxC,IAAS,OAAO,mDAAwB;QAElE;;;WAGG;QACH,aAAa,yDAAG,IAAI,EAAA;QAEpB;;;;;WAKG;QACH,UAAU,GAAG,KAAK,CAAA;QAElB;;;;;;;WAOG;QACH,IAAI,MAAM;YACR,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACrC,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAA;YACrC,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC1C,CAAC;QAED,MAAM,CAAC,YAAY,CAAC,QAAiC,EAAE;YACrD,MAAM,EAAE,GAAG,GAAG,MAAM,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,KAAK,CAAA;YAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAA;YACzE,MAAM,MAAM,GAAmB;gBAC7B,IAAI,EAAE,YAAY;gBAClB,GAAG;gBACH,IAAI;gBACJ,OAAO;aACR,CAAA;YACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;YACjC,CAAC;YACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzB,MAAM,CAAC,cAAc,GAAG,eAAe,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;YAC/D,CAAC;YACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzB,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAA;YAC9C,CAAC;YACD,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;gBACxB,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAA;YAC5C,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAA;YAChC,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBACrB,MAAM,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAA;YACtC,CAAC;YACD,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;gBACvB,MAAM,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAA;YAC1C,CAAC;YACD,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;gBACzB,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAA;YAC9C,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACjD,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACjD,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED,YAAY,KAA+B,EAAE,MAAyB;YACpE,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,CAAA;YACzC,MAAM,SAAS,GAAiB,EAAE,CAAA;YAClC,IAAI,MAAM,YAAY,UAAU,EAAE,CAAC;gBACjC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACxB,CAAC;iBAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBACxE,SAAS,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAA;YACxC,CAAC;iBAAM,IAAI,MAAM,EAAE,CAAC;gBAClB,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;YACvF,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;YACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;YACrB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;YACnB,IAAI,CAAC,IAAI,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAA;YACrB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAC5D,CAAC;YACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,IAAI,CAAC,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;YAC1D,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAC9C,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAC9C,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;YACnB,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,IAAI,CAAC,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACpD,CAAC;YACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,IAAI,CAAC,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;YACxD,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAA;YAC3C,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAC7B,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAA;YAC7B,CAAC;YACD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;YAC1B,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACxC,IAAI,CAAC,YAAY,EAAE,CAAA;YACrB,CAAC,CAAC,CAAA;QACJ,CAAC;QAED,MAAM;YACJ,MAAM,MAAM,GAAmB;gBAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;gBACxB,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;aACvC,CAAA;YACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;YAChC,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACnC,MAAM,CAAC,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAC9D,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,CAAC,cAAc,GAAG,eAAe,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;YAC9D,CAAC;YACD,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,CAAC,aAAa,GAAG,eAAe,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;YAC5D,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YAChD,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACpB,MAAM,CAAC,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;YACtD,CAAC;YACD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACtB,MAAM,CAAC,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;YAC1D,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAA;YAC7C,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;YAC7D,CAAC;YACD,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAA;YAC7D,CAAC;YACD,OAAO,MAAM,CAAA;QACf,CAAC;QAED;;;;WAIG;QACH,YAAY;YACV,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC1C,OAAM;YACR,CAAC;YACD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAA;YACtB,cAAc,CAAC,GAAG,EAAE;gBAClB,IAAI,CAAC,UAAU,GAAG,KAAK,CAAA;gBACvB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAA;gBACjC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;YAC3B,CAAC,CAAC,CAAA;QACJ,CAAC;QAED;;;;;WAKG;QACH,YAAY,CAAC,SAAiB;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAA;YAC9D,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,CAAA;YACjB,CAAC;YACD,MAAM,SAAS,GAAkB;gBAC/B,GAAG,EAAE,SAAS;gBACd,OAAO,EAAE,EAAE;aACZ,CAAA;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YAC5B,IAAI,CAAC,YAAY,EAAE,CAAA;YACnB,OAAO,SAAS,CAAA;QAClB,CAAC;QAED;;;WAGG;QACH,YAAY,CAAC,SAAiB;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAA;YAChE,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;gBAC7B,IAAI,CAAC,YAAY,EAAE,CAAA;YACrB,CAAC;QACH,CAAC;QACD;;;;WAIG;QACH,gBAAgB,CAAC,SAAiB;YAChC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAA;QACtD,CAAC;QAED;;;;WAIG;QACH,oBAAoB;YAClB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA;YACzB,IAAI,CAAC,cAAc,GAAG,EAAE,CAAA;YACxB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAA;YACjB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAA;YACrB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,EAAE,CAAA;YAC9B,CAAC;YACD,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,cAAc,CAAC,QAAQ,KAAK,kBAAkB,EAAE,CAAC;gBAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,cAA+C,CAAA;gBAClE,KAAK,CAAC,WAAW,GAAG,SAAS,CAAA;YAC/B,CAAC;YACD,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,CAAC,QAAQ,IAAI,MAAM,EAAE,CAAC;gBAChE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAwC,CAAA;gBAC3D,KAAK,CAAC,OAAO,GAAG,EAAE,CAAA;YACpB,CAAC;QACH,CAAC;QAED;;;;;;WAMG;QACH,gBAAgB,CAAC,MAAkB;YACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAA;YAC3G,CAAC;YACD,IAAI,CAAC,oBAAoB,EAAE,CAAA;YAC3B,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;YACzC,IAAI,CAAC,cAAc,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;YACzE,IAAI,CAAC,YAAY,EAAE,CAAA;QACrB,CAAC;;;SAzUU,QAAQ","sourcesContent":["import { nanoid } from '../nanoid.js'\nimport { ApiModelKind, DataDomainKind } from '../models/kinds.js'\nimport { type IThing, Thing } from '../models/Thing.js'\nimport type {\n  AccessRule,\n  AssociationTarget,\n  AuthenticationConfiguration,\n  AuthorizationConfiguration,\n  ExposedEntity,\n  RateLimitingConfiguration,\n  RolesBasedAccessControl,\n  SessionConfiguration,\n  UsernamePasswordConfiguration,\n} from './types.js'\nimport { DataDomain } from './DataDomain.js'\nimport { DependentModel, type DependentModelSchema, type DomainDependency } from './DependentModel.js'\nimport { observed, toRaw } from '../decorators/observed.js'\n\n/**\n * Contact information for the exposed API.\n */\nexport interface ApiContact {\n  /**\n   * The identifying name of the contact person/organization.\n   */\n  name?: string\n  /**\n   * The URL pointing to the contact information. MUST be in the format of a URL.\n   */\n  url?: string\n  /**\n   * The email address of the contact person/organization. MUST be in the format of an email address.\n   */\n  email?: string\n}\n\n/**\n * License information for the exposed API.\n */\nexport interface ApiLicense {\n  /**\n   * The license name used for the API. It is recommended to be an SPDX license identifier.\n   */\n  name: string\n  /**\n   * A URL to the license used for the API. MUST be in the format of a URL.\n   */\n  url?: string\n}\n\nexport interface ApiModelSchema extends DependentModelSchema {\n  /**\n   * The data domain kind recognizable by the ecosystem.\n   */\n  kind: typeof ApiModelKind\n  /**\n   * The unique key of the data domain schema.\n   * This is a stable identifier that does not change across versions.\n   */\n  key: string\n  /**\n   * Contains the name, display name, description, and the version of the data domain schema.\n   */\n  info: IThing\n\n  /**\n   * The designated Data Entity that represents a \"User\".\n   * This entity should be marked with the \"User\" semantic in the Data Modeler.\n   *\n   * This property is required to publish the API.\n   */\n  user?: AssociationTarget\n\n  /**\n   * Configuration for how users prove their identity.\n   * The API model is invalid if this is not set.\n   */\n  authentication?: AuthenticationConfiguration\n\n  /**\n   * Configuration for what authenticated users are allowed to do.\n   * The API model is invalid if this is not set.\n   */\n  authorization?: AuthorizationConfiguration\n\n  /**\n   * Configuration for the transport and payload of the user session.\n   * The API model is invalid if this is not set.\n   */\n  session?: SessionConfiguration\n  /**\n   * The specific subset of Data Entities to be exposed by this API.\n   * These are the entities that are included in the data domain schema.\n   */\n  exposes: ExposedEntity[]\n\n  /**\n   * Optional array of access rules that define the access control policies\n   * for the API. These rules are used to enforce security and permissions\n   * on the exposed entities.\n   *\n   * These rules apply to all exposed entities and actions. An API action\n   * can declare its own access rules, which will override these.\n   */\n  accessRule?: AccessRule[]\n  /**\n   * Optional configuration for API-wide rate limiting and throttling.\n   * Defines rules to protect the API from overuse.\n   */\n  rateLimiting?: RateLimitingConfiguration\n  /**\n   * A URL to the Terms of Service for the API.\n   */\n  termsOfService?: string\n  /**\n   * The contact information for the exposed API.\n   */\n  contact?: ApiContact\n  /**\n   * The license information for the API.\n   */\n  license?: ApiLicense\n}\n\nexport class ApiModel extends DependentModel {\n  /**\n   * The data domain kind recognizable by the ecosystem.\n   */\n  kind: typeof ApiModelKind\n  /**\n   * The unique key of the data domain schema.\n   * This is a stable identifier that does not change across versions.\n   */\n  key: string\n\n  /**\n   * The description of the domain property.\n   */\n  info: Thing\n  /**\n   * The designated Data Entity that represents a \"User\".\n   * This entity must be marked with the \"User\" semantic in the Data Modeler.\n   *\n   * This property is required to publish the API.\n   */\n  user?: AssociationTarget\n\n  /**\n   * Configuration for how users prove their identity.\n   * The API model is invalid if this is not set.\n   */\n  authentication?: AuthenticationConfiguration\n\n  /**\n   * Configuration for what authenticated users are allowed to do.\n   * The API model is invalid if this is not set.\n   */\n  authorization?: AuthorizationConfiguration\n\n  /**\n   * Configuration for the transport and payload of the user session.\n   * The API model is invalid if this is not set.\n   */\n  session?: SessionConfiguration\n  /**\n   * The specific subset of Data Entities to be exposed by this API.\n   * These are the entities that are included in the data domain schema.\n   */\n  exposes: ExposedEntity[]\n  /**\n   * Optional array of access rules that define the access control policies\n   * for the API. These rules are used to enforce security and permissions\n   * on the exposed entities.\n   *\n   * These rules apply to all exposed entities and actions. An API action\n   * can declare its own access rules, which will override these.\n   */\n  accessRule?: AccessRule[]\n  /**\n   * Optional configuration for API-wide rate limiting and throttling.\n   * Defines rules to protect the API from overuse.\n   */\n  rateLimiting?: RateLimitingConfiguration\n  /**\n   * A URL to the Terms of Service for the API.\n   */\n  @observed() accessor termsOfService: string | undefined\n  /**\n   * The contact information for the exposed API.\n   */\n  @observed({ deep: true }) accessor contact: ApiContact | undefined\n  /**\n   * The license information for the API.\n   */\n  @observed({ deep: true }) accessor license: ApiLicense | undefined\n\n  /**\n   * When the initializing flag is set to true,\n   * the domain is not notified of changes.\n   */\n  #initializing = true\n\n  /**\n   * When the notifying flag is set to true,\n   * the domain is pending a notification.\n   * No other notifications will be sent until\n   * the current notification is sent.\n   */\n  #notifying = false\n\n  /**\n   * A convenience getter that returns the DataDomain associated with this API model.\n   * Since the API model can have only one DataDomain,\n   * this getter returns the first dependency in the list.\n   *\n   * The parent interface `DependentModel` allows for multiple dependencies,\n   * to unify the dependency management across different models.\n   */\n  get domain(): DataDomain | undefined {\n    if (this.dependencyList.length === 0) {\n      return undefined\n    }\n    const domain = this.dependencyList[0]\n    return this.dependencies.get(domain.key)\n  }\n\n  static createSchema(input: Partial<ApiModelSchema> = {}): ApiModelSchema {\n    const { key = nanoid(), exposes = [] } = input\n    const info = Thing.fromJSON(input.info, { name: 'Unnamed API' }).toJSON()\n    const result: ApiModelSchema = {\n      kind: ApiModelKind,\n      key,\n      info,\n      exposes,\n    }\n    if (input.user) {\n      result.user = { ...input.user }\n    }\n    if (input.dependencyList) {\n      result.dependencyList = structuredClone(input.dependencyList)\n    }\n    if (input.authentication) {\n      result.authentication = input.authentication\n    }\n    if (input.authorization) {\n      result.authorization = input.authorization\n    }\n    if (input.session) {\n      result.session = input.session\n    }\n    if (input.accessRule) {\n      result.accessRule = input.accessRule\n    }\n    if (input.rateLimiting) {\n      result.rateLimiting = input.rateLimiting\n    }\n    if (input.termsOfService) {\n      result.termsOfService = input.termsOfService\n    }\n    if (input.contact) {\n      result.contact = structuredClone(input.contact)\n    }\n    if (input.license) {\n      result.license = structuredClone(input.license)\n    }\n    return result\n  }\n\n  constructor(state?: Partial<ApiModelSchema>, domain?: DomainDependency) {\n    const init = ApiModel.createSchema(state)\n    const instances: DataDomain[] = []\n    if (domain instanceof DataDomain) {\n      instances.push(domain)\n    } else if (typeof domain === 'object' && domain.kind === DataDomainKind) {\n      instances.push(new DataDomain(domain))\n    } else if (domain) {\n      throw new Error(`Invalid domain provided. Expected a DataDomain instance or schema.`)\n    }\n    super(init.dependencyList, instances)\n    this.kind = init.kind\n    this.key = init.key\n    this.info = new Thing(init.info)\n    this.user = init.user\n    if (init.authentication) {\n      this.authentication = structuredClone(init.authentication)\n    }\n    if (init.authorization) {\n      this.authorization = structuredClone(init.authorization)\n    }\n    if (init.session) {\n      this.session = structuredClone(init.session)\n    }\n    if (Array.isArray(init.exposes)) {\n      this.exposes = structuredClone(init.exposes)\n    } else {\n      this.exposes = []\n    }\n    if (init.accessRule) {\n      this.accessRule = structuredClone(init.accessRule)\n    }\n    if (init.rateLimiting) {\n      this.rateLimiting = structuredClone(init.rateLimiting)\n    }\n    if (init.termsOfService) {\n      this.termsOfService = init.termsOfService\n    }\n    if (init.contact) {\n      this.contact = init.contact\n    }\n    if (init.license) {\n      this.license = init.license\n    }\n    this.#initializing = false\n    this.info.addEventListener('change', () => {\n      this.notifyChange()\n    })\n  }\n\n  toJSON(): ApiModelSchema {\n    const result: ApiModelSchema = {\n      kind: this.kind,\n      key: this.key,\n      info: this.info.toJSON(),\n      exposes: structuredClone(this.exposes),\n    }\n    if (this.user) {\n      result.user = { ...this.user }\n    }\n    if (this.dependencyList.length > 0) {\n      result.dependencyList = structuredClone(this.dependencyList)\n    }\n    if (this.authentication) {\n      result.authentication = structuredClone(this.authentication)\n    }\n    if (this.authorization) {\n      result.authorization = structuredClone(this.authorization)\n    }\n    if (this.session) {\n      result.session = structuredClone(this.session)\n    }\n    if (this.accessRule) {\n      result.accessRule = structuredClone(this.accessRule)\n    }\n    if (this.rateLimiting) {\n      result.rateLimiting = structuredClone(this.rateLimiting)\n    }\n    if (this.termsOfService) {\n      result.termsOfService = this.termsOfService\n    }\n    if (this.contact) {\n      result.contact = structuredClone(toRaw(this, this.contact))\n    }\n    if (this.license) {\n      result.license = structuredClone(toRaw(this, this.license))\n    }\n    return result\n  }\n\n  /**\n   * This function is used internally by all domain elements to notify that something has changed.\n   * Since we want to notify listeners after the operation commits, we use microtask\n   * to ensure that the event is dispatched after the current operation.\n   */\n  notifyChange() {\n    if (this.#notifying || this.#initializing) {\n      return\n    }\n    this.#notifying = true\n    queueMicrotask(() => {\n      this.#notifying = false\n      const event = new Event('change')\n      this.dispatchEvent(event)\n    })\n  }\n\n  /**\n   * Exposes a new entity in the API model.\n   * If the entity already exists, it returns the existing one.\n   * @param entityKey The key of the entity to expose.\n   * @returns The exposed entity.\n   */\n  exposeEntity(entityKey: string): ExposedEntity {\n    const existing = this.exposes.find((e) => e.key === entityKey)\n    if (existing) {\n      return existing\n    }\n    const newEntity: ExposedEntity = {\n      key: entityKey,\n      actions: [],\n    }\n    this.exposes.push(newEntity)\n    this.notifyChange()\n    return newEntity\n  }\n\n  /**\n   * Removes an entity from the API model.\n   * @param entityKey The key of the entity to remove.\n   */\n  removeEntity(entityKey: string): void {\n    const index = this.exposes.findIndex((e) => e.key === entityKey)\n    if (index !== -1) {\n      this.exposes.splice(index, 1)\n      this.notifyChange()\n    }\n  }\n  /**\n   * Returns the exposed entity by its key.\n   * @param entityKey The key of the entity to find.\n   * @returns The exposed entity or undefined if not found.\n   */\n  getExposedEntity(entityKey: string): ExposedEntity | undefined {\n    return this.exposes.find((e) => e.key === entityKey)\n  }\n\n  /**\n   * Clears the API model for a new entity change.\n   * This method resets the dependencies, exposes, user,\n   * authentication, authorization, and session properties.\n   */\n  cleanForEntityChange(): void {\n    this.dependencies.clear()\n    this.dependencyList = []\n    this.exposes = []\n    this.user = undefined\n    if (this.session) {\n      this.session.properties = []\n    }\n    if (this.authentication && this.authentication.strategy === 'UsernamePassword') {\n      const typed = this.authentication as UsernamePasswordConfiguration\n      typed.passwordKey = undefined\n    }\n    if (this.authorization && this.authorization.strategy == 'RBAC') {\n      const typed = this.authorization as RolesBasedAccessControl\n      typed.roleKey = ''\n    }\n  }\n\n  /**\n   * Attaches a DataDomain to this API model.\n   * This method clears any existing dependencies and sets the new domain.\n   *\n   * @param domain The DataDomain to attach to this API model.\n   * @throws Error if the domain does not have a version set in its info.\n   */\n  attachDataDomain(domain: DataDomain): void {\n    if (!domain.info.version) {\n      throw new Error(`Cannot attach DataDomain without a version. Please set the version in the domain info.`)\n    }\n    this.cleanForEntityChange()\n    this.dependencies.set(domain.key, domain)\n    this.dependencyList = [{ key: domain.key, version: domain.info.version }]\n    this.notifyChange()\n  }\n}\n"]}

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

@@ -1,6 +1,6 @@
 import { Graph } from '@api-client/graph/graph/Graph.js';
 import { DataDomainKind } from '../models/kinds.js';
-import type { AssociationAddOptions, DeserializationIssue, DeserializationMode, DomainGraphEdge, DomainGraphNodeType, SerializedGraph } from './types.js';
+import type { AssociationAddOptions, DeserializationIssue, DeserializationMode, DomainGraphEdge, DomainGraphNodeType, SerializedGraph, DomainSearchCriteria, DomainSearchResult } from './types.js';
 import { type DomainNamespaceSchema, DomainNamespace, type NamespaceOrderedItem } from './DomainNamespace.js';
 import { type DomainModelSchema, DomainModel } from './DomainModel.js';
 import { type DomainEntitySchema, DomainEntity } from './DomainEntity.js';
@@ -662,5 +662,39 @@ export declare class DataDomain extends DependentModel {
      * ```
      */
     removeDomainElement(key: string, kind: string): void;
+    /**
+     * Searches domain nodes by text content and/or node type.
+     *
+     * This function traverses the graph and filters nodes based on the provided search criteria.
+     * It can search through name, displayName, and description fields of domain objects,
+     * and optionally filter by specific node types.
+     *
+     * @param criteria Search criteria including query string/regex and filtering options.
+     * @returns An array of search results containing matching nodes and metadata.
+     *
+     * @example
+     * ```typescript
+     * // Search for nodes containing "user" in any text field
+     * const results = dataDomain.search({ query: 'user' });
+     *
+     * // Search for entities only
+     * const entityResults = dataDomain.search({
+     *   nodeTypes: [DomainEntityKind]
+     * });
+     *
+     * // Search for "user" in entities and properties with case-sensitive matching
+     * const specificResults = dataDomain.search({
+     *   query: 'User',
+     *   nodeTypes: [DomainEntityKind, DomainPropertyKind],
+     *   caseSensitive: true
+     * });
+     *
+     * // Search using regex pattern
+     * const regexResults = dataDomain.search({
+     *   query: /^user/i
+     * });
+     * ```
+     */
+    search(criteria?: DomainSearchCriteria): DomainSearchResult[];
 }
 //# sourceMappingURL=DataDomain.d.ts.map

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

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

package/build/src/modeling/DataDomain.js

@@ -1277,5 +1277,125 @@ export class DataDomain extends DependentModel {
                 throw new Error(`Unknown kind ${kind} for the object ${key}`);
         }
     }
+    /**
+     * Searches domain nodes by text content and/or node type.
+     *
+     * This function traverses the graph and filters nodes based on the provided search criteria.
+     * It can search through name, displayName, and description fields of domain objects,
+     * and optionally filter by specific node types.
+     *
+     * @param criteria Search criteria including query string/regex and filtering options.
+     * @returns An array of search results containing matching nodes and metadata.
+     *
+     * @example
+     * ```typescript
+     * // Search for nodes containing "user" in any text field
+     * const results = dataDomain.search({ query: 'user' });
+     *
+     * // Search for entities only
+     * const entityResults = dataDomain.search({
+     *   nodeTypes: [DomainEntityKind]
+     * });
+     *
+     * // Search for "user" in entities and properties with case-sensitive matching
+     * const specificResults = dataDomain.search({
+     *   query: 'User',
+     *   nodeTypes: [DomainEntityKind, DomainPropertyKind],
+     *   caseSensitive: true
+     * });
+     *
+     * // Search using regex pattern
+     * const regexResults = dataDomain.search({
+     *   query: /^user/i
+     * });
+     * ```
+     */
+    search(criteria = {}) {
+        const { query, nodeTypes, includeForeignDomains = false, caseSensitive = false } = criteria;
+        const results = [];
+        // If no criteria provided, return all nodes
+        const shouldReturnAll = !query && (!nodeTypes || nodeTypes.length === 0);
+        // Helper function to check if a node matches the type filter
+        const matchesNodeType = (nodeKind) => {
+            if (!nodeTypes || nodeTypes.length === 0) {
+                return true;
+            }
+            return nodeTypes.includes(nodeKind);
+        };
+        // Helper function to check if text matches the query
+        const matchesQuery = (text) => {
+            if (!text || !query) {
+                return !query; // If no query, consider it a match
+            }
+            if (query instanceof RegExp) {
+                return query.test(text);
+            }
+            // String query
+            const searchText = caseSensitive ? text : text.toLowerCase();
+            const searchQuery = caseSensitive ? query : query.toLowerCase();
+            return searchText.includes(searchQuery);
+        };
+        // Helper function to get matched fields for a node
+        const getMatchedFields = (node) => {
+            if (!query) {
+                return []; // No query means no specific field matching
+            }
+            const matched = [];
+            const { info } = node;
+            if (matchesQuery(info.name)) {
+                matched.push('name');
+            }
+            if (matchesQuery(info.displayName)) {
+                matched.push('displayName');
+            }
+            if (matchesQuery(info.description)) {
+                matched.push('description');
+            }
+            return matched;
+        };
+        // Helper function to determine if a node key belongs to a foreign domain
+        const isForeignNode = (nodeKey) => {
+            return nodeKey.includes(':');
+        };
+        // Iterate through all nodes in the graph
+        for (const nodeKey of this.graph.nodes()) {
+            const node = this.graph.node(nodeKey);
+            // Skip if node doesn't exist or doesn't have required properties
+            if (!node || !node.info) {
+                continue;
+            }
+            const isForeign = isForeignNode(nodeKey);
+            // Skip foreign nodes if not requested
+            if (isForeign && !includeForeignDomains) {
+                continue;
+            }
+            // Check node type filter
+            if (!matchesNodeType(node.kind)) {
+                continue;
+            }
+            // If returning all nodes (no specific criteria), add the node
+            if (shouldReturnAll) {
+                results.push({
+                    node,
+                    matchedFields: [],
+                    key: nodeKey,
+                    isForeign,
+                });
+                continue;
+            }
+            // Check text query match
+            const matchedFields = getMatchedFields(node);
+            const hasTextMatch = !query || matchedFields.length > 0;
+            if (hasTextMatch) {
+                results.push({
+                    node,
+                    matchedFields,
+                    key: nodeKey,
+                    isForeign,
+                });
+            }
+        }
+        return results;
+    }
 }
 //# sourceMappingURL=DataDomain.js.map