@api-client/core 0.18.30 → 0.18.31

package/data/models/example-generator-api.json

@@ -42068,10 +42068,10 @@
 "@id": "#194"
 },
 {
-"@id": "#197"
+"@id": "#200"
 },
 {
-"@id": "#200"
+"@id": "#197"
 },
 {
 "@id": "#203"
@@ -43478,7 +43478,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: '5'\ndescription: 'Limited company'\n",
+"doc:raw": "class: '3'\ndescription: '150 - 300'\nnumberOfFte: 5500\nnumberOfEmployees: 5232\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43499,7 +43499,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "class: '3'\ndescription: '150 - 300'\nnumberOfFte: 5500\nnumberOfEmployees: 5232\n",
+"doc:raw": "code: '5'\ndescription: 'Limited company'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44766,12 +44766,12 @@
 {
 "@id": "#199/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#199",
-"sourcemaps:value": "[(1,0)-(3,0)]"
+"sourcemaps:value": "[(1,0)-(5,0)]"
 },
 {
 "@id": "#202/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#202",
-"sourcemaps:value": "[(1,0)-(5,0)]"
+"sourcemaps:value": "[(1,0)-(3,0)]"
 },
 {
 "@id": "#205/source-map/lexical/element_0",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@api-client/core",
   "description": "The API Client's core client library. Works in NodeJS and in a ES enabled browser.",
-  "version": "0.18.30",
+  "version": "0.18.31",
   "license": "Apache-2.0",
   "exports": {
     "./browser.js": {

package/src/modeling/ApiModel.ts

@@ -401,12 +401,20 @@ export class ApiModel extends DependentModel {
       throw new Error(`Entity not found in domain: ${entity.key}`)
     }
     const name = domainEntity.info.name || ''
+    const segment = pluralize(name.toLocaleLowerCase())
+    const relativeCollectionPath = `/${segment}`
+    const relativeResourcePath = `/${segment}/{id}`
+    const absoluteCollectionPath = relativeCollectionPath
+    const absoluteResourcePath = relativeResourcePath
     const newEntity: ExposedEntity = {
       key: nanoid(),
       entity: { ...entity },
       actions: [],
       isRoot: true,
-      path: pluralize(name.toLocaleLowerCase()),
+      relativeCollectionPath,
+      relativeResourcePath,
+      absoluteCollectionPath,
+      absoluteResourcePath,
     }
     if (options) {
       newEntity.exposeOptions = { ...options }
@@ -479,13 +487,24 @@ export class ApiModel extends DependentModel {
           if (!targetDomainEntity) continue
 
           const name = association.info.name || ''
+          const parentExposure = this.exposes.find((e) => e.key === parentKey)
+          const parentAbsResource = parentExposure?.absoluteResourcePath || ''
+          const segment = pluralize(name.toLocaleLowerCase())
+          const isCollection = association.multiple !== false
+          const relativeCollectionPath = isCollection ? `/${segment}` : undefined
+          const relativeResourcePath = isCollection ? `/${segment}/{id}` : `/${segment}`
+          const absoluteCollectionPath = isCollection ? `${parentAbsResource}${relativeCollectionPath}` : undefined
+          const absoluteResourcePath = `${parentAbsResource}${relativeResourcePath}`
           // Create nested exposure
           const nestedExposure: ExposedEntity = {
             key: nanoid(),
             entity: { ...target },
             actions: [],
             isRoot: false,
-            path: pluralize(name.toLocaleLowerCase()),
+            relativeCollectionPath,
+            relativeResourcePath,
+            absoluteCollectionPath,
+            absoluteResourcePath,
             parent: {
               key: parentKey,
               association: {

package/src/modeling/types.ts

@@ -449,9 +449,28 @@ export interface ExposedEntity {
    */
   entity: AssociationTarget
   /**
-   * The path segment for this exposure.
+   * Relative path to the collection endpoint for this exposure.
+   * Starts with '/'. Not set for 1:1 nested exposures where collection does not exist.
    */
-  path: string
+  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
+
+  /**
+   * Absolute path to the collection endpoint for this exposure (includes parent paths).
+   * Starts with '/'. Not set for 1:1 nested exposures where collection does not exist.
+   */
+  absoluteCollectionPath?: string
+
+  /**
+   * Absolute path to the resource endpoint for this exposure (includes parent paths).
+   * Starts with '/'.
+   */
+  absoluteResourcePath: string
 
   /**
    * Whether this exposure is a root exposure (top-level collection).

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

@@ -81,7 +81,8 @@ test.group('ApiModel.exposeEntity()', () => {
     const nestedB = model.exposes.find((e) => !e.isRoot && e.entity.key === eB.key)
     assert.isDefined(nestedB)
     assert.deepEqual(nestedB?.parent?.key, exposedA.key)
-    assert.strictEqual(nestedB?.path, 'entitybs')
+    assert.strictEqual(nestedB?.relativeCollectionPath, '/entitybs')
+    assert.strictEqual(nestedB?.absoluteCollectionPath, '/as/{id}/entitybs')
   })
 
   test('does not infinitely expose circular associations', ({ assert }) => {