@api-client/core 0.18.30 → 0.18.32

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  ExposeOptions,\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'\nimport pluralize from '@jarrodek/pluralize'\nimport { createDomainKey } from './helpers/keying.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 API model 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 API model 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 entity The entity key and domain to expose.\n   * @returns The exposed entity.\n   */\n  exposeEntity(entity: AssociationTarget, options?: ExposeOptions): ExposedEntity {\n    const domain = this.domain\n    if (!domain) {\n      throw new Error(`No domain attached to API model`)\n    }\n    // checks whether the entity is already exposed as a root exposure.\n    const existing = this.exposes.find(\n      (e) => e.isRoot && e.entity.key === entity.key && e.entity.domain === entity.domain\n    )\n    if (existing) {\n      // quietly return the existing exposure\n      // TBD: should we throw an error here?\n      return existing\n    }\n    const domainEntity = domain.findEntity(entity.key, entity.domain)\n    if (!domainEntity) {\n      throw new Error(`Entity not found in domain: ${entity.key}`)\n    }\n    const name = domainEntity.info.name || ''\n    const newEntity: ExposedEntity = {\n      key: nanoid(),\n      entity: { ...entity },\n      actions: [],\n      isRoot: true,\n      path: pluralize(name.toLocaleLowerCase()),\n    }\n    if (options) {\n      newEntity.exposeOptions = { ...options }\n    }\n    this.exposes.push(newEntity)\n\n    // Follow associations if requested\n    if (options?.followAssociations) {\n      if (options?.maxDepth === undefined || options.maxDepth > 0) {\n        this.followEntityAssociations(newEntity, options)\n      }\n    }\n    this.notifyChange()\n    return newEntity\n  }\n\n  /**\n   * Follows associations for a newly exposed entity if configured to do so.\n   * This creates nested exposures based on the entity's associations.\n   *\n   * @param parentExposure The root exposure to follow associations from\n   * @param options The expose options containing follow configuration\n   */\n  private followEntityAssociations(parentExposure: ExposedEntity, options: ExposeOptions): void {\n    const domain = this.domain\n    if (!domain) {\n      return\n    }\n    const maxDepth = options.maxDepth ?? 6\n    const visited = new Set<string>()\n    // Add parent entity's key to the visited set so we won't skip it when traversing\n    // associations.\n    visited.add(createDomainKey(parentExposure.entity))\n\n    const follow = (currentEntity: AssociationTarget, parentKey: string, depth: number) => {\n      // Find the domain entity\n      const domainEntity = domain.findEntity(currentEntity.key, currentEntity.domain)\n      if (!domainEntity) return\n\n      // Iterate through associations\n      for (const association of domainEntity.listAssociations()) {\n        for (const target of association.targets) {\n          // Skip self-referencing associations\n          if (target.key === currentEntity.key && target.domain === currentEntity.domain) {\n            continue\n          }\n\n          // Create unique identifier for circular detection\n          const visitKey = createDomainKey(target)\n          if (visited.has(visitKey)) {\n            continue // Skip circular references\n          }\n          visited.add(visitKey)\n\n          // Check if this nested exposure already exists\n          const existingNested = this.exposes.find(\n            (e) =>\n              !e.isRoot &&\n              e.entity.key === target.key &&\n              e.entity.domain === target.domain &&\n              e.parent?.key === parentKey\n          )\n\n          if (existingNested) {\n            continue // Already exposed under this parent\n          }\n\n          // Find the target domain entity for path generation\n          const targetDomainEntity = domain.findEntity(target.key, target.domain)\n          if (!targetDomainEntity) continue\n\n          const name = association.info.name || ''\n          // Create nested exposure\n          const nestedExposure: ExposedEntity = {\n            key: nanoid(),\n            entity: { ...target },\n            actions: [],\n            isRoot: false,\n            path: pluralize(name.toLocaleLowerCase()),\n            parent: {\n              key: parentKey,\n              association: {\n                key: association.key,\n                domain: currentEntity.domain,\n              },\n              depth: depth + 1,\n            },\n          }\n\n          this.exposes.push(nestedExposure)\n          if (depth + 1 >= maxDepth) {\n            nestedExposure.truncated = true\n          } else {\n            // Recursively follow associations\n            follow(target, nestedExposure.key, depth + 1)\n          }\n        }\n      }\n    }\n\n    // Start following from the root exposure\n    follow(parentExposure.entity, parentExposure.key, 0)\n  }\n\n  /**\n   * Removes an exposed entity from the API model.\n   * @param entity The entity to remove.\n   */\n  removeEntity(entity: AssociationTarget): void {\n    const current = this.exposes.find((e) => e.entity.key === entity.key && e.entity.domain === entity.domain)\n    if (!current) {\n      return\n    }\n    this.removeWithChildren(current.key)\n    this.notifyChange()\n  }\n\n  private removeWithChildren(key: string): void {\n    const index = this.exposes.findIndex((e) => e.key === key)\n    if (index < 0) {\n      return\n    }\n    // Remove the parent itself\n    this.exposes.splice(index, 1)\n    // Remove all children recursively\n    const removeChildren = (parentKey: string) => {\n      // Find all exposures whose parent.key matches parentKey\n      const children = this.exposes.filter((e) => e.parent?.key === parentKey)\n      for (const child of children) {\n        removeChildren(child.key)\n        const childIndex = this.exposes.findIndex((e) => e.key === child.key)\n        if (childIndex >= 0) {\n          this.exposes.splice(childIndex, 1)\n        }\n      }\n    }\n    // Then also remove children\n    removeChildren(key)\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(entity: AssociationTarget): ExposedEntity | undefined {\n    return this.exposes.find((e) => e.entity.key === entity.key && e.entity.domain === entity.domain)\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":"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","sourcesContent":["import { nanoid } from '../nanoid.js'\nimport { ApiModelKind, DataDomainKind, ExposedEntityKind } from '../models/kinds.js'\nimport { type IThing, Thing } from '../models/Thing.js'\nimport type {\n  AccessRule,\n  AssociationTarget,\n  AuthenticationConfiguration,\n  AuthorizationConfiguration,\n  ExposedEntitySchema,\n  RateLimitingConfiguration,\n  RolesBasedAccessControl,\n  SessionConfiguration,\n  UsernamePasswordConfiguration,\n  ExposeOptions,\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'\nimport pluralize from '@jarrodek/pluralize'\nimport { createDomainKey } from './helpers/keying.js'\nimport { ExposedEntity } from './ExposedEntity.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 API model 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 API model 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: ExposedEntitySchema[]\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 = init.exposes.map((e) => new ExposedEntity(this, e))\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: this.exposes.map((e) => e.toJSON()),\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 entity The entity key and domain to expose.\n   * @returns The exposed entity.\n   */\n  exposeEntity(entity: AssociationTarget, options?: ExposeOptions): ExposedEntity {\n    const domain = this.domain\n    if (!domain) {\n      throw new Error(`No domain attached to API model`)\n    }\n    // checks whether the entity is already exposed as a root exposure.\n    const existing = this.exposes.find(\n      (e) => e.isRoot && e.entity.key === entity.key && e.entity.domain === entity.domain\n    )\n    if (existing) {\n      // quietly return the existing exposure\n      // TBD: should we throw an error here?\n      return existing\n    }\n    const domainEntity = domain.findEntity(entity.key, entity.domain)\n    if (!domainEntity) {\n      throw new Error(`Entity not found in domain: ${entity.key}`)\n    }\n    const name = domainEntity.info.name || ''\n    const segment = pluralize(name.toLocaleLowerCase())\n    const relativeCollectionPath = `/${segment}`\n    const relativeResourcePath = `/${segment}/{id}`\n    const newEntity: ExposedEntitySchema = {\n      kind: ExposedEntityKind,\n      key: nanoid(),\n      entity: { ...entity },\n      actions: [],\n      isRoot: true,\n      relativeCollectionPath,\n      relativeResourcePath,\n      hasCollection: true,\n    }\n    if (options) {\n      newEntity.exposeOptions = { ...options }\n    }\n    const created = new ExposedEntity(this, newEntity)\n    this.exposes.push(created)\n\n    // Follow associations if requested\n    if (options?.followAssociations) {\n      if (options?.maxDepth === undefined || options.maxDepth > 0) {\n        this.followEntityAssociations(newEntity, options)\n      }\n    }\n    this.notifyChange()\n    return created\n  }\n\n  /**\n   * Follows associations for a newly exposed entity if configured to do so.\n   * This creates nested exposures based on the entity's associations.\n   *\n   * @param parentExposure The root exposure to follow associations from\n   * @param options The expose options containing follow configuration\n   */\n  private followEntityAssociations(parentExposure: ExposedEntitySchema, options: ExposeOptions): void {\n    const domain = this.domain\n    if (!domain) {\n      return\n    }\n    const maxDepth = options.maxDepth ?? 6\n    const visited = new Set<string>()\n    // Add parent entity's key to the visited set so we won't skip it when traversing\n    // associations.\n    visited.add(createDomainKey(parentExposure.entity))\n\n    const follow = (currentEntity: AssociationTarget, parentKey: string, depth: number) => {\n      // Find the domain entity\n      const domainEntity = domain.findEntity(currentEntity.key, currentEntity.domain)\n      if (!domainEntity) return\n\n      // Iterate through associations\n      for (const association of domainEntity.listAssociations()) {\n        for (const target of association.targets) {\n          // Skip self-referencing associations\n          if (target.key === currentEntity.key && target.domain === currentEntity.domain) {\n            continue\n          }\n\n          // Create unique identifier for circular detection\n          const visitKey = createDomainKey(target)\n          if (visited.has(visitKey)) {\n            continue // Skip circular references\n          }\n          visited.add(visitKey)\n\n          // Check if this nested exposure already exists\n          const existingNested = this.exposes.find(\n            (e) =>\n              !e.isRoot &&\n              e.entity.key === target.key &&\n              e.entity.domain === target.domain &&\n              e.parent?.key === parentKey\n          )\n\n          if (existingNested) {\n            continue // Already exposed under this parent\n          }\n\n          // Find the target domain entity for path generation\n          const targetDomainEntity = domain.findEntity(target.key, target.domain)\n          if (!targetDomainEntity) continue\n\n          const name = association.info.name || ''\n          const segment = pluralize(name.toLocaleLowerCase())\n          const isCollection = association.multiple !== false\n          const relativeCollectionPath = isCollection ? `/${segment}` : undefined\n          const relativeResourcePath = isCollection ? `/${segment}/{id}` : `/${segment}`\n          // Create nested exposure\n          const nestedExposure: ExposedEntitySchema = {\n            kind: ExposedEntityKind,\n            key: nanoid(),\n            entity: { ...target },\n            actions: [],\n            isRoot: false,\n            relativeCollectionPath,\n            relativeResourcePath,\n            hasCollection: isCollection,\n            parent: {\n              key: parentKey,\n              association: {\n                key: association.key,\n                domain: currentEntity.domain,\n              },\n              depth: depth + 1,\n            },\n          }\n\n          this.exposes.push(new ExposedEntity(this, nestedExposure))\n          if (depth + 1 >= maxDepth) {\n            nestedExposure.truncated = true\n          } else {\n            // Recursively follow associations\n            follow(target, nestedExposure.key, depth + 1)\n          }\n        }\n      }\n    }\n\n    // Start following from the root exposure\n    follow(parentExposure.entity, parentExposure.key, 0)\n  }\n\n  /**\n   * Removes an exposed entity from the API model.\n   * @param entity The entity to remove.\n   */\n  removeEntity(entity: AssociationTarget): void {\n    const current = this.exposes.find((e) => e.entity.key === entity.key && e.entity.domain === entity.domain)\n    if (!current) {\n      return\n    }\n    this.removeWithChildren(current.key)\n    this.notifyChange()\n  }\n\n  private removeWithChildren(key: string): void {\n    const index = this.exposes.findIndex((e) => e.key === key)\n    if (index < 0) {\n      return\n    }\n    // Remove the parent itself\n    this.exposes.splice(index, 1)\n    // Remove all children recursively\n    const removeChildren = (parentKey: string) => {\n      // Find all exposures whose parent.key matches parentKey\n      const children = this.exposes.filter((e) => e.parent?.key === parentKey)\n      for (const child of children) {\n        removeChildren(child.key)\n        const childIndex = this.exposes.findIndex((e) => e.key === child.key)\n        if (childIndex >= 0) {\n          this.exposes.splice(childIndex, 1)\n        }\n      }\n    }\n    // Then also remove children\n    removeChildren(key)\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(entity: AssociationTarget): ExposedEntity | undefined {\n    return this.exposes.find((e) => e.entity.key === entity.key && e.entity.domain === entity.domain)\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/ExposedEntity.d.ts

@@ -0,0 +1,114 @@
+import { ExposedEntityKind } from '../models/kinds.js';
+import type { ApiModel } from './ApiModel.js';
+import type { AccessRule, ApiAction, AssociationTarget, ExposeOptions, ExposeParentRef, RateLimitingConfiguration, ExposedEntitySchema } from './types.js';
+/**
+ * A class that specializes in representing an exposed Data Entity within an API Model.
+ *
+ * @fires change - Emitted when the exposed entity has changed.
+ */
+export declare class ExposedEntity extends EventTarget {
+    #private;
+    /**
+     * The exposed entity kind recognizable by the ecosystem.
+     */
+    kind: typeof ExposedEntityKind;
+    /**
+     * The unique key of the exposed entity.
+     * This is a stable identifier that does not change across versions.
+     */
+    key: string;
+    /**
+     * A pointer to a Data Entity from the Data Domain.
+     */
+    entity: AssociationTarget;
+    /**
+     * Indicates whether this exposure has a collection endpoint.
+     * A collection endpoint is optional for nested exposures where the association is 1:1
+     * and the schema is embedded directly under the parent resource.
+     */
+    hasCollection: boolean;
+    /**
+     * Relative path to the collection endpoint for this exposure.
+     * Starts with '/'. Not set for 1:1 nested exposures where collection does not exist.
+     */
+    relativeCollectionPath?: string;
+    /**
+     * Relative path to the resource endpoint for this exposure.
+     * Starts with '/'. For 1:1 nested exposures the resource path typically does not include an id segment.
+     */
+    relativeResourcePath: string;
+    /**
+     * Whether this exposure is a root exposure (top-level collection).
+     * If this is set then the `parent` reference must be populated.
+     */
+    isRoot?: boolean;
+    /**
+     * Parent reference when this exposure was created via following an association.
+     */
+    parent?: ExposeParentRef;
+    /**
+     * Expose-time config used to create this exposure (persisted for auditing/UI).
+     * This is only populated for the root exposure. All children exposures inherit this config.
+     */
+    exposeOptions?: ExposeOptions;
+    /**
+     * The list of enabled API actions for this exposure (List/Read/Create/etc.)
+     */
+    actions: ApiAction[];
+    /**
+     * Optional array of access rules that define the access control policies for this exposure.
+     */
+    accessRule?: AccessRule[];
+    /**
+     * Optional configuration for rate limiting for this exposure.
+     */
+    rateLimiting?: RateLimitingConfiguration;
+    /**
+     * When true, generation for this exposure hit configured limits
+     */
+    truncated?: boolean;
+    /**
+     * A reference to the parent API Model instance.
+     */
+    api: ApiModel;
+    static createSchema(input?: Partial<ExposedEntitySchema>): ExposedEntitySchema;
+    constructor(model: ApiModel, state?: Partial<ExposedEntitySchema>);
+    notifyChange(): void;
+    toJSON(): ExposedEntitySchema;
+    /**
+     * Sets a new relative collection path for this exposed entity.
+     *
+     * It:
+     * - updates the relativeCollectionPath property
+     * - updates the absoluteCollectionPath property accordingly
+     * - updates the relativeResourcePath and absoluteResourcePath accordingly.
+     * @param path The new path to set.
+     */
+    setRelativeCollectionPath(path: string): void;
+    /**
+     * Sets a new relative resource path for this exposed entity.
+     *
+     * Rules:
+     * - Must start with '/'.
+     * - If this exposure has a collection, the path must be exactly the collection path plus a single
+     *   parameter segment (e.g. `/products/{productId}`) and only the parameter name may vary.
+     * - If this exposure does NOT have a collection, the path can be any two segments (e.g. `/profile/{id}` or `/a/b`).
+     */
+    setRelativeResourcePath(path: string): void;
+    /**
+     * Computes the absolute path for this exposure's resource endpoint by
+     * walking up the exposure tree using `parent.key` until reaching a root exposure.
+     * The absolute path is composed by concatenating each ancestor's resource path
+     * with this exposure's relative resource path.
+     */
+    getAbsoluteResourcePath(): string;
+    /**
+     * Computes the absolute path for this exposure's collection endpoint (if any)
+     * by walking up the exposure tree using `parent.key` until reaching a root exposure.
+     * The absolute path is composed by concatenating each ancestor's resource path
+     * with this exposure's relative collection path.
+     * Returns undefined if this exposure has no collection.
+     */
+    getAbsoluteCollectionPath(): string | undefined;
+}
+//# sourceMappingURL=ExposedEntity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExposedEntity.d.ts","sourceRoot":"","sources":["../../../src/modeling/ExposedEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,OAAO,KAAK,EACV,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,aAAa,EACb,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,YAAY,CAAA;AAEnB;;;;GAIG;AACH,qBAAa,aAAc,SAAQ,WAAW;;IAC5C;;OAEG;IACH,IAAI,EAAE,OAAO,iBAAiB,CAAA;IAE9B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAA;IAEX;;OAEG;IACH,MAAM,EAAE,iBAAiB,CAAA;IAEzB;;;;OAIG;IACH,aAAa,EAAE,OAAO,CAAA;IAEtB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAE/B;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAE5B;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAA;IAEhB;;OAEG;IACH,MAAM,CAAC,EAAE,eAAe,CAAA;IAExB;;;OAGG;IACH,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B;;OAEG;IACH,OAAO,EAAE,SAAS,EAAE,CAAA;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,UAAU,EAAE,CAAA;IAEzB;;OAEG;IACH,YAAY,CAAC,EAAE,yBAAyB,CAAA;IAExC;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IASnB;;OAEG;IACH,GAAG,EAAE,QAAQ,CAAA;IAEb,MAAM,CAAC,YAAY,CAAC,KAAK,GAAE,OAAO,CAAC,mBAAmB,CAAM,GAAG,mBAAmB;gBA+CtE,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAmBjE,YAAY;IAYZ,MAAM,IAAI,mBAAmB;IAiC7B;;;;;;;;OAQG;IACH,yBAAyB,CAAC,IAAI,EAAE,MAAM;IA2BtC;;;;;;;;OAQG;IACH,uBAAuB,CAAC,IAAI,EAAE,MAAM;IA0CpC;;;;;OAKG;IACH,uBAAuB,IAAI,MAAM;IAcjC;;;;;;OAMG;IACH,yBAAyB,IAAI,MAAM,GAAG,SAAS;CAchD"}

package/build/src/modeling/ExposedEntity.js

@@ -0,0 +1,300 @@
+import { ExposedEntityKind } from '../models/kinds.js';
+import { nanoid } from '../nanoid.js';
+import { ensureLeadingSlash, joinPaths } from './helpers/endpointHelpers.js';
+/**
+ * A class that specializes in representing an exposed Data Entity within an API Model.
+ *
+ * @fires change - Emitted when the exposed entity has changed.
+ */
+export class ExposedEntity extends EventTarget {
+    /**
+     * The exposed entity kind recognizable by the ecosystem.
+     */
+    kind;
+    /**
+     * The unique key of the exposed entity.
+     * This is a stable identifier that does not change across versions.
+     */
+    key;
+    /**
+     * A pointer to a Data Entity from the Data Domain.
+     */
+    entity;
+    /**
+     * Indicates whether this exposure has a collection endpoint.
+     * A collection endpoint is optional for nested exposures where the association is 1:1
+     * and the schema is embedded directly under the parent resource.
+     */
+    hasCollection;
+    /**
+     * Relative path to the collection endpoint for this exposure.
+     * Starts with '/'. Not set for 1:1 nested exposures where collection does not exist.
+     */
+    relativeCollectionPath;
+    /**
+     * Relative path to the resource endpoint for this exposure.
+     * Starts with '/'. For 1:1 nested exposures the resource path typically does not include an id segment.
+     */
+    relativeResourcePath;
+    /**
+     * Whether this exposure is a root exposure (top-level collection).
+     * If this is set then the `parent` reference must be populated.
+     */
+    isRoot;
+    /**
+     * Parent reference when this exposure was created via following an association.
+     */
+    parent;
+    /**
+     * Expose-time config used to create this exposure (persisted for auditing/UI).
+     * This is only populated for the root exposure. All children exposures inherit this config.
+     */
+    exposeOptions;
+    /**
+     * The list of enabled API actions for this exposure (List/Read/Create/etc.)
+     */
+    actions;
+    /**
+     * Optional array of access rules that define the access control policies for this exposure.
+     */
+    accessRule;
+    /**
+     * Optional configuration for rate limiting for this exposure.
+     */
+    rateLimiting;
+    /**
+     * When true, generation for this exposure hit configured limits
+     */
+    truncated;
+    /**
+     * When the notifying flag is set to true,
+     * the domain is pending a notification.
+     * No other notifications will be sent until
+     * the current notification is sent.
+     */
+    #notifying = false;
+    /**
+     * A reference to the parent API Model instance.
+     */
+    api;
+    static createSchema(input = {}) {
+        const { key = nanoid(), entity = { key: '' }, relativeCollectionPath, relativeResourcePath = '/', hasCollection = true, isRoot, parent, exposeOptions, actions = [], accessRule, rateLimiting, truncated, } = input;
+        const result = {
+            kind: ExposedEntityKind,
+            key,
+            entity: { ...entity },
+            hasCollection,
+            relativeResourcePath,
+            actions: actions.map((a) => ({ ...a })),
+        };
+        if (relativeCollectionPath !== undefined) {
+            result.relativeCollectionPath = relativeCollectionPath;
+        }
+        if (isRoot !== undefined) {
+            result.isRoot = isRoot;
+        }
+        if (parent !== undefined) {
+            result.parent = { ...parent };
+        }
+        if (exposeOptions !== undefined) {
+            result.exposeOptions = { ...exposeOptions };
+        }
+        if (accessRule !== undefined) {
+            result.accessRule = accessRule.map((ar) => ({ ...ar }));
+        }
+        if (rateLimiting !== undefined) {
+            result.rateLimiting = { ...rateLimiting };
+        }
+        if (truncated !== undefined) {
+            result.truncated = truncated;
+        }
+        return result;
+    }
+    constructor(model, state) {
+        super();
+        this.api = model;
+        const init = ExposedEntity.createSchema(state);
+        this.kind = init.kind;
+        this.key = init.key;
+        this.entity = init.entity;
+        this.hasCollection = init.hasCollection;
+        this.relativeCollectionPath = init.relativeCollectionPath;
+        this.relativeResourcePath = init.relativeResourcePath;
+        this.isRoot = init.isRoot;
+        this.parent = init.parent;
+        this.exposeOptions = init.exposeOptions;
+        this.actions = init.actions;
+        this.accessRule = init.accessRule;
+        this.rateLimiting = init.rateLimiting;
+        this.truncated = init.truncated;
+    }
+    notifyChange() {
+        if (this.#notifying) {
+            return;
+        }
+        this.#notifying = true;
+        queueMicrotask(() => {
+            this.#notifying = false;
+            const event = new Event('change');
+            this.dispatchEvent(event);
+        });
+    }
+    toJSON() {
+        const result = {
+            kind: this.kind,
+            key: this.key,
+            entity: { ...this.entity },
+            relativeResourcePath: this.relativeResourcePath,
+            actions: this.actions.map((a) => ({ ...a })),
+            hasCollection: this.hasCollection,
+        };
+        if (this.relativeCollectionPath !== undefined) {
+            result.relativeCollectionPath = this.relativeCollectionPath;
+        }
+        if (this.isRoot !== undefined) {
+            result.isRoot = this.isRoot;
+        }
+        if (this.parent !== undefined) {
+            result.parent = { ...this.parent };
+        }
+        if (this.exposeOptions !== undefined) {
+            result.exposeOptions = { ...this.exposeOptions };
+        }
+        if (this.accessRule !== undefined) {
+            result.accessRule = this.accessRule.map((ar) => ({ ...ar }));
+        }
+        if (this.rateLimiting !== undefined) {
+            result.rateLimiting = { ...this.rateLimiting };
+        }
+        if (this.truncated !== undefined) {
+            result.truncated = this.truncated;
+        }
+        return result;
+    }
+    /**
+     * Sets a new relative collection path for this exposed entity.
+     *
+     * It:
+     * - updates the relativeCollectionPath property
+     * - updates the absoluteCollectionPath property accordingly
+     * - updates the relativeResourcePath and absoluteResourcePath accordingly.
+     * @param path The new path to set.
+     */
+    setRelativeCollectionPath(path) {
+        if (!this.hasCollection) {
+            throw new Error(`Cannot set collection path on an exposure that does not have a collection`);
+        }
+        const cleaned = ensureLeadingSlash(path);
+        // Ensure exactly one non-empty segment
+        const segments = cleaned.split('/').filter(Boolean);
+        if (segments.length !== 1) {
+            throw new Error(`Collection path must contain exactly one segment. Received: "${path}"`);
+        }
+        const normalizedCollection = `/${segments[0]}`;
+        // Preserve current parameter name if present, otherwise default to {id}
+        let param = '{id}';
+        if (this.relativeResourcePath) {
+            const curSegments = this.relativeResourcePath.split('/').filter(Boolean);
+            const maybeParam = curSegments[1];
+            if (maybeParam && /^\{[A-Za-z_][A-Za-z0-9_]*\}$/.test(maybeParam)) {
+                param = maybeParam;
+            }
+        }
+        const nextResource = `${normalizedCollection}/${param}`;
+        const changed = this.relativeCollectionPath !== normalizedCollection || this.relativeResourcePath !== nextResource;
+        this.relativeCollectionPath = normalizedCollection;
+        this.relativeResourcePath = nextResource;
+        if (changed)
+            this.notifyChange();
+    }
+    /**
+     * Sets a new relative resource path for this exposed entity.
+     *
+     * Rules:
+     * - Must start with '/'.
+     * - If this exposure has a collection, the path must be exactly the collection path plus a single
+     *   parameter segment (e.g. `/products/{productId}`) and only the parameter name may vary.
+     * - If this exposure does NOT have a collection, the path can be any two segments (e.g. `/profile/{id}` or `/a/b`).
+     */
+    setRelativeResourcePath(path) {
+        const cleaned = ensureLeadingSlash(path);
+        const segments = cleaned.split('/').filter(Boolean);
+        if (this.hasCollection) {
+            if (!this.relativeCollectionPath) {
+                throw new Error('Cannot set resource path: missing collection path for this exposure');
+            }
+            const colSegments = this.relativeCollectionPath.split('/').filter(Boolean);
+            if (colSegments.length !== 1) {
+                throw new Error(`Invalid stored collection path "${this.relativeCollectionPath}"`);
+            }
+            if (segments.length !== 2) {
+                throw new Error(`Resource path must be exactly two segments (collection + parameter). Received: "${cleaned}"`);
+            }
+            const [s1, s2] = segments;
+            if (s1 !== colSegments[0]) {
+                throw new Error(`Resource path must start with the collection segment "${colSegments[0]}". Received: "${s1}"`);
+            }
+            // s2 must be a parameter segment {name}
+            if (!/^\{[A-Za-z_][A-Za-z0-9_]*\}$/.test(s2)) {
+                throw new Error(`The second segment must be a parameter in braces, e.g. {id}. Received: "${s2}"`);
+            }
+            if (this.relativeResourcePath !== cleaned) {
+                this.relativeResourcePath = `/${s1}/${s2}`;
+                this.notifyChange();
+            }
+            return;
+        }
+        // No collection: allow any two segments
+        if (segments.length !== 2) {
+            throw new Error(`Resource path must contain exactly two segments when no collection is present. Received: "${cleaned}"`);
+        }
+        if (this.relativeResourcePath !== cleaned) {
+            this.relativeResourcePath = `/${segments[0]}/${segments[1]}`;
+            this.notifyChange();
+        }
+    }
+    /**
+     * Computes the absolute path for this exposure's resource endpoint by
+     * walking up the exposure tree using `parent.key` until reaching a root exposure.
+     * The absolute path is composed by concatenating each ancestor's resource path
+     * with this exposure's relative resource path.
+     */
+    getAbsoluteResourcePath() {
+        let absolute = ensureLeadingSlash(this.relativeResourcePath);
+        // Traverse parents, always joining with the parent's resource path
+        let parentKey = this.parent?.key;
+        while (parentKey) {
+            const parent = this.api.exposes.find((e) => e.key === parentKey);
+            if (!parent)
+                break;
+            const parentResource = ensureLeadingSlash(parent.relativeResourcePath);
+            absolute = joinPaths(parentResource, absolute);
+            parentKey = parent.parent?.key;
+        }
+        return absolute;
+    }
+    /**
+     * Computes the absolute path for this exposure's collection endpoint (if any)
+     * by walking up the exposure tree using `parent.key` until reaching a root exposure.
+     * The absolute path is composed by concatenating each ancestor's resource path
+     * with this exposure's relative collection path.
+     * Returns undefined if this exposure has no collection.
+     */
+    getAbsoluteCollectionPath() {
+        if (!this.hasCollection || !this.relativeCollectionPath)
+            return undefined;
+        let absolute = ensureLeadingSlash(this.relativeCollectionPath);
+        // Traverse parents, always joining with the parent's resource path
+        let parentKey = this.parent?.key;
+        while (parentKey) {
+            const parent = this.api.exposes.find((e) => e.key === parentKey);
+            if (!parent)
+                break;
+            const parentResource = ensureLeadingSlash(parent.relativeResourcePath);
+            absolute = joinPaths(parentResource, absolute);
+            parentKey = parent.parent?.key;
+        }
+        return absolute;
+    }
+}
+//# sourceMappingURL=ExposedEntity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ExposedEntity.js","sourceRoot":"","sources":["../../../src/modeling/ExposedEntity.ts"],"names":[],"mappings":"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","sourcesContent":["import { ExposedEntityKind } from '../models/kinds.js'\nimport { nanoid } from '../nanoid.js'\nimport type { ApiModel } from './ApiModel.js'\nimport { ensureLeadingSlash, joinPaths } from './helpers/endpointHelpers.js'\nimport type {\n  AccessRule,\n  ApiAction,\n  AssociationTarget,\n  ExposeOptions,\n  ExposeParentRef,\n  RateLimitingConfiguration,\n  ExposedEntitySchema,\n} from './types.js'\n\n/**\n * A class that specializes in representing an exposed Data Entity within an API Model.\n *\n * @fires change - Emitted when the exposed entity has changed.\n */\nexport class ExposedEntity extends EventTarget {\n  /**\n   * The exposed entity kind recognizable by the ecosystem.\n   */\n  kind: typeof ExposedEntityKind\n\n  /**\n   * The unique key of the exposed entity.\n   * This is a stable identifier that does not change across versions.\n   */\n  key: string\n\n  /**\n   * A pointer to a Data Entity from the Data Domain.\n   */\n  entity: AssociationTarget\n\n  /**\n   * Indicates whether this exposure has a collection endpoint.\n   * A collection endpoint is optional for nested exposures where the association is 1:1\n   * and the schema is embedded directly under the parent resource.\n   */\n  hasCollection: boolean\n\n  /**\n   * Relative path to the collection endpoint for this exposure.\n   * Starts with '/'. Not set for 1:1 nested exposures where collection does not exist.\n   */\n  relativeCollectionPath?: string\n\n  /**\n   * Relative path to the resource endpoint for this exposure.\n   * Starts with '/'. For 1:1 nested exposures the resource path typically does not include an id segment.\n   */\n  relativeResourcePath: string\n\n  /**\n   * Whether this exposure is a root exposure (top-level collection).\n   * If this is set then the `parent` reference must be populated.\n   */\n  isRoot?: boolean\n\n  /**\n   * Parent reference when this exposure was created via following an association.\n   */\n  parent?: ExposeParentRef\n\n  /**\n   * Expose-time config used to create this exposure (persisted for auditing/UI).\n   * This is only populated for the root exposure. All children exposures inherit this config.\n   */\n  exposeOptions?: ExposeOptions\n\n  /**\n   * The list of enabled API actions for this exposure (List/Read/Create/etc.)\n   */\n  actions: ApiAction[]\n\n  /**\n   * Optional array of access rules that define the access control policies for this exposure.\n   */\n  accessRule?: AccessRule[]\n\n  /**\n   * Optional configuration for rate limiting for this exposure.\n   */\n  rateLimiting?: RateLimitingConfiguration\n\n  /**\n   * When true, generation for this exposure hit configured limits\n   */\n  truncated?: boolean\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   * A reference to the parent API Model instance.\n   */\n  api: ApiModel\n\n  static createSchema(input: Partial<ExposedEntitySchema> = {}): ExposedEntitySchema {\n    const {\n      key = nanoid(),\n      entity = { key: '' },\n      relativeCollectionPath,\n      relativeResourcePath = '/',\n      hasCollection = true,\n      isRoot,\n      parent,\n      exposeOptions,\n      actions = [],\n      accessRule,\n      rateLimiting,\n      truncated,\n    } = input\n    const result: ExposedEntitySchema = {\n      kind: ExposedEntityKind,\n      key,\n      entity: { ...entity },\n      hasCollection,\n      relativeResourcePath,\n      actions: actions.map((a) => ({ ...a })),\n    }\n    if (relativeCollectionPath !== undefined) {\n      result.relativeCollectionPath = relativeCollectionPath\n    }\n    if (isRoot !== undefined) {\n      result.isRoot = isRoot\n    }\n    if (parent !== undefined) {\n      result.parent = { ...parent }\n    }\n    if (exposeOptions !== undefined) {\n      result.exposeOptions = { ...exposeOptions }\n    }\n    if (accessRule !== undefined) {\n      result.accessRule = accessRule.map((ar) => ({ ...ar }))\n    }\n    if (rateLimiting !== undefined) {\n      result.rateLimiting = { ...rateLimiting }\n    }\n    if (truncated !== undefined) {\n      result.truncated = truncated\n    }\n    return result\n  }\n\n  constructor(model: ApiModel, state?: Partial<ExposedEntitySchema>) {\n    super()\n    this.api = model\n    const init = ExposedEntity.createSchema(state)\n    this.kind = init.kind\n    this.key = init.key\n    this.entity = init.entity\n    this.hasCollection = init.hasCollection\n    this.relativeCollectionPath = init.relativeCollectionPath\n    this.relativeResourcePath = init.relativeResourcePath\n    this.isRoot = init.isRoot\n    this.parent = init.parent\n    this.exposeOptions = init.exposeOptions\n    this.actions = init.actions\n    this.accessRule = init.accessRule\n    this.rateLimiting = init.rateLimiting\n    this.truncated = init.truncated\n  }\n\n  notifyChange() {\n    if (this.#notifying) {\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  toJSON(): ExposedEntitySchema {\n    const result: ExposedEntitySchema = {\n      kind: this.kind,\n      key: this.key,\n      entity: { ...this.entity },\n      relativeResourcePath: this.relativeResourcePath,\n      actions: this.actions.map((a) => ({ ...a })),\n      hasCollection: this.hasCollection,\n    }\n    if (this.relativeCollectionPath !== undefined) {\n      result.relativeCollectionPath = this.relativeCollectionPath\n    }\n    if (this.isRoot !== undefined) {\n      result.isRoot = this.isRoot\n    }\n    if (this.parent !== undefined) {\n      result.parent = { ...this.parent }\n    }\n    if (this.exposeOptions !== undefined) {\n      result.exposeOptions = { ...this.exposeOptions }\n    }\n    if (this.accessRule !== undefined) {\n      result.accessRule = this.accessRule.map((ar) => ({ ...ar }))\n    }\n    if (this.rateLimiting !== undefined) {\n      result.rateLimiting = { ...this.rateLimiting }\n    }\n    if (this.truncated !== undefined) {\n      result.truncated = this.truncated\n    }\n    return result\n  }\n\n  /**\n   * Sets a new relative collection path for this exposed entity.\n   *\n   * It:\n   * - updates the relativeCollectionPath property\n   * - updates the absoluteCollectionPath property accordingly\n   * - updates the relativeResourcePath and absoluteResourcePath accordingly.\n   * @param path The new path to set.\n   */\n  setRelativeCollectionPath(path: string) {\n    if (!this.hasCollection) {\n      throw new Error(`Cannot set collection path on an exposure that does not have a collection`)\n    }\n    const cleaned = ensureLeadingSlash(path)\n    // Ensure exactly one non-empty segment\n    const segments = cleaned.split('/').filter(Boolean)\n    if (segments.length !== 1) {\n      throw new Error(`Collection path must contain exactly one segment. Received: \"${path}\"`)\n    }\n    const normalizedCollection = `/${segments[0]}`\n    // Preserve current parameter name if present, otherwise default to {id}\n    let param = '{id}'\n    if (this.relativeResourcePath) {\n      const curSegments = this.relativeResourcePath.split('/').filter(Boolean)\n      const maybeParam = curSegments[1]\n      if (maybeParam && /^\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(maybeParam)) {\n        param = maybeParam\n      }\n    }\n    const nextResource = `${normalizedCollection}/${param}`\n    const changed = this.relativeCollectionPath !== normalizedCollection || this.relativeResourcePath !== nextResource\n    this.relativeCollectionPath = normalizedCollection\n    this.relativeResourcePath = nextResource\n    if (changed) this.notifyChange()\n  }\n\n  /**\n   * Sets a new relative resource path for this exposed entity.\n   *\n   * Rules:\n   * - Must start with '/'.\n   * - If this exposure has a collection, the path must be exactly the collection path plus a single\n   *   parameter segment (e.g. `/products/{productId}`) and only the parameter name may vary.\n   * - If this exposure does NOT have a collection, the path can be any two segments (e.g. `/profile/{id}` or `/a/b`).\n   */\n  setRelativeResourcePath(path: string) {\n    const cleaned = ensureLeadingSlash(path)\n    const segments = cleaned.split('/').filter(Boolean)\n\n    if (this.hasCollection) {\n      if (!this.relativeCollectionPath) {\n        throw new Error('Cannot set resource path: missing collection path for this exposure')\n      }\n      const colSegments = this.relativeCollectionPath.split('/').filter(Boolean)\n      if (colSegments.length !== 1) {\n        throw new Error(`Invalid stored collection path \"${this.relativeCollectionPath}\"`)\n      }\n      if (segments.length !== 2) {\n        throw new Error(`Resource path must be exactly two segments (collection + parameter). Received: \"${cleaned}\"`)\n      }\n      const [s1, s2] = segments\n      if (s1 !== colSegments[0]) {\n        throw new Error(`Resource path must start with the collection segment \"${colSegments[0]}\". Received: \"${s1}\"`)\n      }\n      // s2 must be a parameter segment {name}\n      if (!/^\\{[A-Za-z_][A-Za-z0-9_]*\\}$/.test(s2)) {\n        throw new Error(`The second segment must be a parameter in braces, e.g. {id}. Received: \"${s2}\"`)\n      }\n      if (this.relativeResourcePath !== cleaned) {\n        this.relativeResourcePath = `/${s1}/${s2}`\n        this.notifyChange()\n      }\n      return\n    }\n\n    // No collection: allow any two segments\n    if (segments.length !== 2) {\n      throw new Error(\n        `Resource path must contain exactly two segments when no collection is present. Received: \"${cleaned}\"`\n      )\n    }\n    if (this.relativeResourcePath !== cleaned) {\n      this.relativeResourcePath = `/${segments[0]}/${segments[1]}`\n      this.notifyChange()\n    }\n  }\n\n  /**\n   * Computes the absolute path for this exposure's resource endpoint by\n   * walking up the exposure tree using `parent.key` until reaching a root exposure.\n   * The absolute path is composed by concatenating each ancestor's resource path\n   * with this exposure's relative resource path.\n   */\n  getAbsoluteResourcePath(): string {\n    let absolute = ensureLeadingSlash(this.relativeResourcePath)\n    // Traverse parents, always joining with the parent's resource path\n    let parentKey = this.parent?.key\n    while (parentKey) {\n      const parent = this.api.exposes.find((e) => e.key === parentKey)\n      if (!parent) break\n      const parentResource = ensureLeadingSlash(parent.relativeResourcePath)\n      absolute = joinPaths(parentResource, absolute)\n      parentKey = parent.parent?.key\n    }\n    return absolute\n  }\n\n  /**\n   * Computes the absolute path for this exposure's collection endpoint (if any)\n   * by walking up the exposure tree using `parent.key` until reaching a root exposure.\n   * The absolute path is composed by concatenating each ancestor's resource path\n   * with this exposure's relative collection path.\n   * Returns undefined if this exposure has no collection.\n   */\n  getAbsoluteCollectionPath(): string | undefined {\n    if (!this.hasCollection || !this.relativeCollectionPath) return undefined\n    let absolute = ensureLeadingSlash(this.relativeCollectionPath)\n    // Traverse parents, always joining with the parent's resource path\n    let parentKey = this.parent?.key\n    while (parentKey) {\n      const parent = this.api.exposes.find((e) => e.key === parentKey)\n      if (!parent) break\n      const parentResource = ensureLeadingSlash(parent.relativeResourcePath)\n      absolute = joinPaths(parentResource, absolute)\n      parentKey = parent.parent?.key\n    }\n    return absolute\n  }\n}\n"]}

package/build/src/modeling/helpers/endpointHelpers.d.ts

@@ -1,2 +1,13 @@
 export declare function paramNameFor(entityKeyLocal: string): string;
+/**
+ * Ensures the path starts with a single leading slash and has no trailing slash (except root '/')
+ * @param path The path fragment to normalize
+ */
+export declare function ensureLeadingSlash(path: string): string;
+/**
+ * Joins two absolute-like fragments ensuring single slashes between segments
+ * @param left The left path fragment
+ * @param right The right path fragment
+ */
+export declare function joinPaths(left: string, right: string): string;
 //# sourceMappingURL=endpointHelpers.d.ts.map

package/build/src/modeling/helpers/endpointHelpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"endpointHelpers.d.ts","sourceRoot":"","sources":["../../../../src/modeling/helpers/endpointHelpers.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAI3D"}
+{"version":3,"file":"endpointHelpers.d.ts","sourceRoot":"","sources":["../../../../src/modeling/helpers/endpointHelpers.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAI3D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAI7D"}