@api-client/core 0.18.47 → 0.18.49

package/build/src/mocking/ModelingMock.d.ts

@@ -7,6 +7,7 @@ import { Invitation } from './lib/Invitation.js';
 import { Trash } from './lib/Trash.js';
 import { Patch } from './lib/Patch.js';
 import { DataCatalog } from './lib/DataCatalog.js';
+import { Permission } from './lib/Permission.js';
 export declare class ModelingMock {
     faker: Faker;
     organization: Organization;
@@ -17,5 +18,6 @@ export declare class ModelingMock {
     trash: Trash;
     patch: Patch;
     dataCatalog: DataCatalog;
+    permission: Permission;
 }
 //# sourceMappingURL=ModelingMock.d.ts.map

package/build/src/mocking/ModelingMock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModelingMock.d.ts","sourceRoot":"","sources":["../../../src/mocking/ModelingMock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,qBAAa,YAAY;IACvB,KAAK,EAAE,KAAK,CAAQ;IACpB,YAAY,eAAqB;IACjC,KAAK,QAAc;IACnB,KAAK,OAAa;IAClB,KAAK,OAAa;IAClB,UAAU,aAAmB;IAC7B,KAAK,QAAc;IACnB,KAAK,QAAc;IACnB,WAAW,cAAoB;CAChC"}
+{"version":3,"file":"ModelingMock.d.ts","sourceRoot":"","sources":["../../../src/mocking/ModelingMock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,qBAAa,YAAY;IACvB,KAAK,EAAE,KAAK,CAAQ;IACpB,YAAY,eAAqB;IACjC,KAAK,QAAc;IACnB,KAAK,OAAa;IAClB,KAAK,OAAa;IAClB,UAAU,aAAmB;IAC7B,KAAK,QAAc;IACnB,KAAK,QAAc;IACnB,WAAW,cAAoB;IAC/B,UAAU,aAAmB;CAC9B"}

package/build/src/mocking/ModelingMock.js

@@ -7,6 +7,7 @@ import { Invitation } from './lib/Invitation.js';
 import { Trash } from './lib/Trash.js';
 import { Patch } from './lib/Patch.js';
 import { DataCatalog } from './lib/DataCatalog.js';
+import { Permission } from './lib/Permission.js';
 export class ModelingMock {
     faker = faker;
     organization = new Organization();
@@ -17,5 +18,6 @@ export class ModelingMock {
     trash = new Trash();
     patch = new Patch();
     dataCatalog = new DataCatalog();
+    permission = new Permission();
 }
 //# sourceMappingURL=ModelingMock.js.map

package/build/src/mocking/ModelingMock.js.map

@@ -1 +1 @@
-{"version":3,"file":"ModelingMock.js","sourceRoot":"","sources":["../../../src/mocking/ModelingMock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAc,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,MAAM,OAAO,YAAY;IACvB,KAAK,GAAU,KAAK,CAAA;IACpB,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;IACjC,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IACnB,KAAK,GAAG,IAAI,IAAI,EAAE,CAAA;IAClB,KAAK,GAAG,IAAI,IAAI,EAAE,CAAA;IAClB,UAAU,GAAG,IAAI,UAAU,EAAE,CAAA;IAC7B,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IACnB,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IACnB,WAAW,GAAG,IAAI,WAAW,EAAE,CAAA;CAChC","sourcesContent":["import { faker, type Faker } from '@faker-js/faker'\nimport { Organization } from './lib/Organization.js'\nimport { Group } from './lib/Group.js'\nimport { User } from './lib/User.js'\nimport { File } from './lib/File.js'\nimport { Invitation } from './lib/Invitation.js'\nimport { Trash } from './lib/Trash.js'\nimport { Patch } from './lib/Patch.js'\nimport { DataCatalog } from './lib/DataCatalog.js'\n\nexport class ModelingMock {\n  faker: Faker = faker\n  organization = new Organization()\n  group = new Group()\n  users = new User()\n  files = new File()\n  invitation = new Invitation()\n  trash = new Trash()\n  patch = new Patch()\n  dataCatalog = new DataCatalog()\n}\n"]}
+{"version":3,"file":"ModelingMock.js","sourceRoot":"","sources":["../../../src/mocking/ModelingMock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAc,MAAM,iBAAiB,CAAA;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAEhD,MAAM,OAAO,YAAY;IACvB,KAAK,GAAU,KAAK,CAAA;IACpB,YAAY,GAAG,IAAI,YAAY,EAAE,CAAA;IACjC,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IACnB,KAAK,GAAG,IAAI,IAAI,EAAE,CAAA;IAClB,KAAK,GAAG,IAAI,IAAI,EAAE,CAAA;IAClB,UAAU,GAAG,IAAI,UAAU,EAAE,CAAA;IAC7B,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IACnB,KAAK,GAAG,IAAI,KAAK,EAAE,CAAA;IACnB,WAAW,GAAG,IAAI,WAAW,EAAE,CAAA;IAC/B,UAAU,GAAG,IAAI,UAAU,EAAE,CAAA;CAC9B","sourcesContent":["import { faker, type Faker } from '@faker-js/faker'\nimport { Organization } from './lib/Organization.js'\nimport { Group } from './lib/Group.js'\nimport { User } from './lib/User.js'\nimport { File } from './lib/File.js'\nimport { Invitation } from './lib/Invitation.js'\nimport { Trash } from './lib/Trash.js'\nimport { Patch } from './lib/Patch.js'\nimport { DataCatalog } from './lib/DataCatalog.js'\nimport { Permission } from './lib/Permission.js'\n\nexport class ModelingMock {\n  faker: Faker = faker\n  organization = new Organization()\n  group = new Group()\n  users = new User()\n  files = new File()\n  invitation = new Invitation()\n  trash = new Trash()\n  patch = new Patch()\n  dataCatalog = new DataCatalog()\n  permission = new Permission()\n}\n"]}

package/build/src/mocking/lib/File.d.ts

@@ -2,6 +2,7 @@ import { type IFile, type FileBreadcrumb } from '../../models/store/File.js';
 export declare class File {
     /**
      * Generates a random file object.
+     * Note that this generator doesn't create the permissions object. Use Permission class for that.
      * @param init Optional values to be present in the object.
      * @returns Random file
      */

package/build/src/mocking/lib/File.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../../../../src/mocking/lib/File.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,KAAK,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAG9F,qBAAa,IAAI;IACf;;;;OAIG;IACH,IAAI,CAAC,IAAI,GAAE,OAAO,CAAC,KAAK,CAAM,GAAG,KAAK;IAQtC;;;;OAIG;IACH,KAAK,CAAC,IAAI,SAAK,GAAG,KAAK,EAAE;IAQzB;;;;OAIG;IACH,MAAM,CAAC,IAAI,GAAE,OAAO,CAAC,KAAK,CAAM,GAAG,KAAK;IAIxC;;;;OAIG;IACH,OAAO,CAAC,IAAI,SAAK,GAAG,KAAK,EAAE;IAQ3B;;;;OAIG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;CAYjD"}
+{"version":3,"file":"File.d.ts","sourceRoot":"","sources":["../../../../src/mocking/lib/File.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,KAAK,KAAK,EAAE,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAG9F,qBAAa,IAAI;IACf;;;;;OAKG;IACH,IAAI,CAAC,IAAI,GAAE,OAAO,CAAC,KAAK,CAAM,GAAG,KAAK;IAQtC;;;;OAIG;IACH,KAAK,CAAC,IAAI,SAAK,GAAG,KAAK,EAAE;IAQzB;;;;OAIG;IACH,MAAM,CAAC,IAAI,GAAE,OAAO,CAAC,KAAK,CAAM,GAAG,KAAK;IAIxC;;;;OAIG;IACH,OAAO,CAAC,IAAI,SAAK,GAAG,KAAK,EAAE;IAQ3B;;;;OAIG;IACH,eAAe,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,EAAE;CAYjD"}

package/build/src/mocking/lib/File.js

@@ -5,6 +5,7 @@ import { nanoid } from '../../nanoid.js';
 export class File {
     /**
      * Generates a random file object.
+     * Note that this generator doesn't create the permissions object. Use Permission class for that.
      * @param init Optional values to be present in the object.
      * @returns Random file
      */

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

@@ -1 +1 @@
-{"version":3,"file":"File.js","sourceRoot":"","sources":["../../../../src/mocking/lib/File.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACjH,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAmC,MAAM,4BAA4B,CAAA;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,MAAM,OAAO,IAAI;IACf;;;;OAIG;IACH,IAAI,CAAC,OAAuB,EAAE;QAC5B,MAAM,EACJ,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,CAAU,CAAC,EAC3G,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,GACzC,GAAG,IAAI,CAAA;QACR,OAAO,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,EAAE,CAAA;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAC1B,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAuB,EAAE;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;IACjD,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAI,GAAG,EAAE;QACf,MAAM,MAAM,GAAG,EAAE,CAAA;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5B,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,IAAa;QAC3B,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA,CAAC,MAAM;QAC9D,MAAM,KAAK,GAAqB,EAAE,CAAA;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GACR,CAAC,KAAK,KAAK,GAAG,CAAC;gBACb,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,CAAU,CAAC;gBACtG,CAAC,CAAC,UAAU,CAAA;YAChB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QACpE,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;CACF","sourcesContent":["import { faker } from '@faker-js/faker'\nimport { ProjectKind, DomainFileKind, CertificateFileKind, FolderKind, ApiFileKind } from '../../models/kinds.js'\nimport { File as CoreFile, type IFile, type FileBreadcrumb } from '../../models/store/File.js'\nimport { nanoid } from '../../nanoid.js'\n\nexport class File {\n  /**\n   * Generates a random file object.\n   * @param init Optional values to be present in the object.\n   * @returns Random file\n   */\n  file(init: Partial<IFile> = {}): IFile {\n    const {\n      kind = faker.helpers.arrayElement([ProjectKind, DomainFileKind, CertificateFileKind, ApiFileKind] as const),\n      info = { name: faker.system.fileName() },\n    } = init\n    return CoreFile.createSchema({ kind, info })\n  }\n\n  /**\n   * Generates a list of random file objects.\n   * @param size Number of files to generate. Default is 25.\n   * @returns List of random files\n   */\n  files(size = 25): IFile[] {\n    const result = []\n    for (let i = 0; i < size; i++) {\n      result.push(this.file())\n    }\n    return result\n  }\n\n  /**\n   * Generates a random folder object.\n   * @param init Optional values to be present in the object.\n   * @returns Random folder\n   */\n  folder(init: Partial<IFile> = {}): IFile {\n    return this.file({ kind: FolderKind, ...init })\n  }\n\n  /**\n   * Generates a list of random folder objects.\n   * @param size Number of folders to generate. Default is 25.\n   * @returns List of random folders\n   */\n  folders(size = 25): IFile[] {\n    const result = []\n    for (let i = 0; i < size; i++) {\n      result.push(this.folder())\n    }\n    return result\n  }\n\n  /**\n   * Generates a random file breadcrumb object.\n   * @param size Optional depth of the breadcrumb. Default is random between 2-3.\n   * @returns Random file breadcrumb\n   */\n  fileBreadcrumbs(size?: number): FileBreadcrumb[] {\n    const depth = size ?? 2 + Math.floor(Math.random() * 2) // 2-3\n    const items: FileBreadcrumb[] = []\n    for (let i = 0; i < depth; i += 1) {\n      const kind =\n        i === depth - 1\n          ? faker.helpers.arrayElement([ProjectKind, DomainFileKind, CertificateFileKind, ApiFileKind] as const)\n          : FolderKind\n      items.push({ key: nanoid(), kind, name: faker.system.fileName() })\n    }\n    return items\n  }\n}\n"]}
+{"version":3,"file":"File.js","sourceRoot":"","sources":["../../../../src/mocking/lib/File.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACjH,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAmC,MAAM,4BAA4B,CAAA;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,MAAM,OAAO,IAAI;IACf;;;;;OAKG;IACH,IAAI,CAAC,OAAuB,EAAE;QAC5B,MAAM,EACJ,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,CAAU,CAAC,EAC3G,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,GACzC,GAAG,IAAI,CAAA;QACR,OAAO,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IAC9C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,EAAE,CAAA;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;QAC1B,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAuB,EAAE;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAAC,CAAA;IACjD,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAI,GAAG,EAAE;QACf,MAAM,MAAM,GAAG,EAAE,CAAA;QACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5B,CAAC;QACD,OAAO,MAAM,CAAA;IACf,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,IAAa;QAC3B,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA,CAAC,MAAM;QAC9D,MAAM,KAAK,GAAqB,EAAE,CAAA;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,MAAM,IAAI,GACR,CAAC,KAAK,KAAK,GAAG,CAAC;gBACb,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,WAAW,CAAU,CAAC;gBACtG,CAAC,CAAC,UAAU,CAAA;YAChB,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;QACpE,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;CACF","sourcesContent":["import { faker } from '@faker-js/faker'\nimport { ProjectKind, DomainFileKind, CertificateFileKind, FolderKind, ApiFileKind } from '../../models/kinds.js'\nimport { File as CoreFile, type IFile, type FileBreadcrumb } from '../../models/store/File.js'\nimport { nanoid } from '../../nanoid.js'\n\nexport class File {\n  /**\n   * Generates a random file object.\n   * Note that this generator doesn't create the permissions object. Use Permission class for that.\n   * @param init Optional values to be present in the object.\n   * @returns Random file\n   */\n  file(init: Partial<IFile> = {}): IFile {\n    const {\n      kind = faker.helpers.arrayElement([ProjectKind, DomainFileKind, CertificateFileKind, ApiFileKind] as const),\n      info = { name: faker.system.fileName() },\n    } = init\n    return CoreFile.createSchema({ kind, info })\n  }\n\n  /**\n   * Generates a list of random file objects.\n   * @param size Number of files to generate. Default is 25.\n   * @returns List of random files\n   */\n  files(size = 25): IFile[] {\n    const result = []\n    for (let i = 0; i < size; i++) {\n      result.push(this.file())\n    }\n    return result\n  }\n\n  /**\n   * Generates a random folder object.\n   * @param init Optional values to be present in the object.\n   * @returns Random folder\n   */\n  folder(init: Partial<IFile> = {}): IFile {\n    return this.file({ kind: FolderKind, ...init })\n  }\n\n  /**\n   * Generates a list of random folder objects.\n   * @param size Number of folders to generate. Default is 25.\n   * @returns List of random folders\n   */\n  folders(size = 25): IFile[] {\n    const result = []\n    for (let i = 0; i < size; i++) {\n      result.push(this.folder())\n    }\n    return result\n  }\n\n  /**\n   * Generates a random file breadcrumb object.\n   * @param size Optional depth of the breadcrumb. Default is random between 2-3.\n   * @returns Random file breadcrumb\n   */\n  fileBreadcrumbs(size?: number): FileBreadcrumb[] {\n    const depth = size ?? 2 + Math.floor(Math.random() * 2) // 2-3\n    const items: FileBreadcrumb[] = []\n    for (let i = 0; i < depth; i += 1) {\n      const kind =\n        i === depth - 1\n          ? faker.helpers.arrayElement([ProjectKind, DomainFileKind, CertificateFileKind, ApiFileKind] as const)\n          : FolderKind\n      items.push({ key: nanoid(), kind, name: faker.system.fileName() })\n    }\n    return items\n  }\n}\n"]}

package/build/src/mocking/lib/Permission.d.ts

@@ -0,0 +1,35 @@
+import { IPermission } from '../../models/store/Permission.js';
+export declare class Permission {
+    /**
+     * Generates a random permission object.
+     * @param init Configuration options for the permission object.
+     * @returns Random permission
+     */
+    permission(init?: Partial<IPermission>): IPermission;
+    /**
+     * Generates a random user permission object.
+     * @param init Configuration options for the permission object.
+     * @returns Random user permission
+     */
+    userPermission(init?: Partial<IPermission>): IPermission;
+    /**
+     * Generates a random group permission object.
+     * @param init Configuration options for the permission object.
+     * @returns Random group permission
+     */
+    groupPermission(init?: Partial<IPermission>): IPermission;
+    /**
+     * Generates a random organization permission object.
+     * @param init Configuration options for the permission object.
+     * @returns Random organization permission
+     */
+    organizationPermission(init?: Partial<IPermission>): IPermission;
+    /**
+     * Generates a list of random permission objects.
+     * @param size The size of the returning array. Default is 25.
+     * @param init Configuration options for the permission object.
+     * @returns List of random permissions
+     */
+    permissions(size?: number, init?: Partial<IPermission>): IPermission[];
+}
+//# sourceMappingURL=Permission.d.ts.map

package/build/src/mocking/lib/Permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Permission.d.ts","sourceRoot":"","sources":["../../../../src/mocking/lib/Permission.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EAKZ,MAAM,kCAAkC,CAAA;AAEzC,qBAAa,UAAU;IACrB;;;;OAIG;IACH,UAAU,CAAC,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW;IA2CxD;;;;OAIG;IACH,cAAc,CAAC,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW;IAI5D;;;;OAIG;IACH,eAAe,CAAC,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW;IAI7D;;;;OAIG;IACH,sBAAsB,CAAC,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW;IAIpE;;;;;OAKG;IACH,WAAW,CAAC,IAAI,SAAK,EAAE,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAAG,WAAW,EAAE;CAOvE"}

package/build/src/mocking/lib/Permission.js

@@ -0,0 +1,89 @@
+import { faker } from '@faker-js/faker';
+import { nanoid } from '../../nanoid.js';
+import { Kind as PermissionKind, } from '../../models/store/Permission.js';
+export class Permission {
+    /**
+     * Generates a random permission object.
+     * @param init Configuration options for the permission object.
+     * @returns Random permission
+     */
+    permission(init = {}) {
+        const type = init.type ?? faker.helpers.arrayElement(['user', 'group', 'organization']);
+        const role = init.role ?? faker.helpers.arrayElement(['reader', 'commenter', 'writer', 'owner']);
+        const result = {
+            kind: PermissionKind,
+            key: init.key ?? nanoid(),
+            type,
+            granteeId: init.granteeId ?? nanoid(),
+            itemId: init.itemId ?? nanoid(),
+            role,
+            addingUser: init.addingUser ?? nanoid(),
+            depth: init.depth ?? 0,
+            sourceRule: init.sourceRule ??
+                faker.helpers.arrayElement([
+                    'direct_user_grant',
+                    'creator_default_owner',
+                    'parent_owner_editor_rule',
+                ]),
+        };
+        if ('displayName' in init) {
+            result.displayName = init.displayName;
+        }
+        else {
+            if (type === 'user') {
+                result.displayName = faker.person.fullName();
+            }
+            else if (type === 'group') {
+                result.displayName = faker.lorem.word();
+            }
+            else if (type === 'organization') {
+                result.displayName = faker.company.name();
+            }
+        }
+        if ('expirationTime' in init) {
+            result.expirationTime = init.expirationTime;
+        }
+        else if (type === 'user' || type === 'group') {
+            result.expirationTime = faker.date.future().getTime();
+        }
+        return result;
+    }
+    /**
+     * Generates a random user permission object.
+     * @param init Configuration options for the permission object.
+     * @returns Random user permission
+     */
+    userPermission(init = {}) {
+        return this.permission({ ...init, type: 'user' });
+    }
+    /**
+     * Generates a random group permission object.
+     * @param init Configuration options for the permission object.
+     * @returns Random group permission
+     */
+    groupPermission(init = {}) {
+        return this.permission({ ...init, type: 'group' });
+    }
+    /**
+     * Generates a random organization permission object.
+     * @param init Configuration options for the permission object.
+     * @returns Random organization permission
+     */
+    organizationPermission(init = {}) {
+        return this.permission({ ...init, type: 'organization' });
+    }
+    /**
+     * Generates a list of random permission objects.
+     * @param size The size of the returning array. Default is 25.
+     * @param init Configuration options for the permission object.
+     * @returns List of random permissions
+     */
+    permissions(size = 25, init = {}) {
+        const result = [];
+        for (let i = 0; i < size; i++) {
+            result.push(this.permission(init));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=Permission.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Permission.js","sourceRoot":"","sources":["../../../../src/mocking/lib/Permission.ts"],"names":[],"mappings":"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","sourcesContent":["import { faker } from '@faker-js/faker'\nimport { nanoid } from '../../nanoid.js'\nimport {\n  IPermission,\n  Kind as PermissionKind,\n  type PermissionRole,\n  type PermissionType,\n  type PermissionSourceRule,\n} from '../../models/store/Permission.js'\n\nexport class Permission {\n  /**\n   * Generates a random permission object.\n   * @param init Configuration options for the permission object.\n   * @returns Random permission\n   */\n  permission(init: Partial<IPermission> = {}): IPermission {\n    const type = init.type ?? faker.helpers.arrayElement(['user', 'group', 'organization'] as PermissionType[])\n    const role = init.role ?? faker.helpers.arrayElement(['reader', 'commenter', 'writer', 'owner'] as PermissionRole[])\n\n    const result: IPermission = {\n      kind: PermissionKind,\n      key: init.key ?? nanoid(),\n      type,\n      granteeId: init.granteeId ?? nanoid(),\n      itemId: init.itemId ?? nanoid(),\n      role,\n      addingUser: init.addingUser ?? nanoid(),\n      depth: init.depth ?? 0,\n      sourceRule:\n        init.sourceRule ??\n        faker.helpers.arrayElement([\n          'direct_user_grant',\n          'creator_default_owner',\n          'parent_owner_editor_rule',\n        ] as PermissionSourceRule[]),\n    }\n\n    if ('displayName' in init) {\n      result.displayName = init.displayName\n    } else {\n      if (type === 'user') {\n        result.displayName = faker.person.fullName()\n      } else if (type === 'group') {\n        result.displayName = faker.lorem.word()\n      } else if (type === 'organization') {\n        result.displayName = faker.company.name()\n      }\n    }\n\n    if ('expirationTime' in init) {\n      result.expirationTime = init.expirationTime\n    } else if (type === 'user' || type === 'group') {\n      result.expirationTime = faker.date.future().getTime()\n    }\n\n    return result\n  }\n\n  /**\n   * Generates a random user permission object.\n   * @param init Configuration options for the permission object.\n   * @returns Random user permission\n   */\n  userPermission(init: Partial<IPermission> = {}): IPermission {\n    return this.permission({ ...init, type: 'user' })\n  }\n\n  /**\n   * Generates a random group permission object.\n   * @param init Configuration options for the permission object.\n   * @returns Random group permission\n   */\n  groupPermission(init: Partial<IPermission> = {}): IPermission {\n    return this.permission({ ...init, type: 'group' })\n  }\n\n  /**\n   * Generates a random organization permission object.\n   * @param init Configuration options for the permission object.\n   * @returns Random organization permission\n   */\n  organizationPermission(init: Partial<IPermission> = {}): IPermission {\n    return this.permission({ ...init, type: 'organization' })\n  }\n\n  /**\n   * Generates a list of random permission objects.\n   * @param size The size of the returning array. Default is 25.\n   * @param init Configuration options for the permission object.\n   * @returns List of random permissions\n   */\n  permissions(size = 25, init: Partial<IPermission> = {}): IPermission[] {\n    const result: IPermission[] = []\n    for (let i = 0; i < size; i++) {\n      result.push(this.permission(init))\n    }\n    return result\n  }\n}\n"]}

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

@@ -191,6 +191,12 @@ export declare class ApiModel extends DependentModel {
     /**
      * Exposes a new entity in the API model.
      * If the entity already exists, it returns the existing one.
+     *
+     * The logic regarding exposing an entity:
+     * - If the entity is already exposed as a root entity, it returns the existing one.
+     * - If the entity has an association, we expose that entity as a nested entity (by setting the parent property).
+     * - If the associated entity is already exposed as a root entity, we do not follow the association.
+     *
      * @param entity The entity key and domain to expose.
      * @returns The exposed entity.
      */
@@ -205,9 +211,11 @@ export declare class ApiModel extends DependentModel {
     private followEntityAssociations;
     /**
      * Removes an exposed entity from the API model.
-     * @param entity The entity to remove.
+     * This also removes any nested exposed entities that are children of the removed entity.
+     *
+     * @param key The key of the exposed entity to remove.
      */
-    removeEntity(entity: AssociationTarget): void;
+    removeExposedEntity(key: string): void;
     private removeWithChildren;
     /**
      * Returns the exposed entity by its key.
@@ -216,11 +224,11 @@ export declare class ApiModel extends DependentModel {
      */
     getExposedEntity(entity: AssociationTarget): ExposedEntity | undefined;
     /**
-     * Clears the API model for a new entity change.
+     * Clears the API model for a new data domain change.
      * This method resets the dependencies, exposes, user,
      * authentication, authorization, and session properties.
      */
-    cleanForEntityChange(): void;
+    cleanForDomainChange(): void;
     /**
      * Attaches a DataDomain to this API model.
      * This method clears any existing dependencies and sets the new domain.

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

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

package/build/src/modeling/ApiModel.js

@@ -189,6 +189,16 @@ let ApiModel = (() => {
             else if (domain) {
                 throw new Error(`Invalid domain provided. Expected a DataDomain instance or schema.`);
             }
+            // Note that since we're using the `DependentModel` class, but the API Model can have only one dependency,
+            // we keep the reference to the data domain under the `dependencyList` property.
+            // It is all handled by the parent class `DependentModel`. This way we simplify the dependency management (loading)
+            // process when the API model is loaded from the API.
+            if (domain) {
+                if (!domain.info.version) {
+                    throw new Error(`Domain ${domain.key} must have a version.`);
+                }
+                init.dependencyList = [{ key: domain.key, version: domain.info.version }];
+            }
             super(init.dependencyList, instances);
             this.kind = init.kind;
             this.key = init.key;
@@ -287,6 +297,12 @@ let ApiModel = (() => {
         /**
          * Exposes a new entity in the API model.
          * If the entity already exists, it returns the existing one.
+         *
+         * The logic regarding exposing an entity:
+         * - If the entity is already exposed as a root entity, it returns the existing one.
+         * - If the entity has an association, we expose that entity as a nested entity (by setting the parent property).
+         * - If the associated entity is already exposed as a root entity, we do not follow the association.
+         *
          * @param entity The entity key and domain to expose.
          * @returns The exposed entity.
          */
@@ -308,8 +324,16 @@ let ApiModel = (() => {
             }
             const name = domainEntity.info.name || '';
             const segment = pluralize(name.toLocaleLowerCase());
-            const relativeCollectionPath = `/${segment}`;
-            const relativeResourcePath = `/${segment}/{id}`;
+            let relativeCollectionPath = `/${segment}`;
+            let relativeResourcePath = `/${segment}/{id}`;
+            // Check for root path collision and resolve by appending a number
+            let counter = 1;
+            const originalCollectionPath = relativeCollectionPath;
+            while (this.exposes.some((e) => e.isRoot && e.collectionPath === relativeCollectionPath)) {
+                relativeCollectionPath = `${originalCollectionPath}-${counter}`;
+                relativeResourcePath = `${relativeCollectionPath}/{id}`;
+                counter++;
+            }
             const newEntity = {
                 kind: ExposedEntityKind,
                 key: nanoid(),
@@ -347,11 +371,7 @@ let ApiModel = (() => {
                 return;
             }
             const maxDepth = options.maxDepth ?? 6;
-            const visited = new Set();
-            // Add parent entity's key to the visited set so we won't skip it when traversing
-            // associations.
-            visited.add(createDomainKey(parentExposure.entity));
-            const follow = (currentEntity, parentKey, depth) => {
+            const follow = (currentEntity, parentKey, depth, currentPath) => {
                 // Find the domain entity
                 const domainEntity = domain.findEntity(currentEntity.key, currentEntity.domain);
                 if (!domainEntity)
@@ -363,19 +383,41 @@ let ApiModel = (() => {
                         if (target.key === currentEntity.key && target.domain === currentEntity.domain) {
                             continue;
                         }
-                        // Create unique identifier for circular detection
-                        const visitKey = createDomainKey(target);
-                        if (visited.has(visitKey)) {
-                            continue; // Skip circular references
+                        const targetKeys = createDomainKey(target);
+                        // Circular dependency check: if this entity is already in our *current* traversal path
+                        if (currentPath.includes(targetKeys)) {
+                            continue;
                         }
-                        visited.add(visitKey);
-                        // Check if this nested exposure already exists
-                        const existingNested = this.exposes.find((e) => !e.isRoot &&
-                            e.entity.key === target.key &&
-                            e.entity.domain === target.domain &&
-                            e.parent?.key === parentKey);
-                        if (existingNested) {
-                            continue; // Already exposed under this parent
+                        // Check if this entity is ALREADY exposed anywhere in the model
+                        const existingExposure = this.getExposedEntity(target);
+                        if (existingExposure) {
+                            // If it's already exposed and NOT root (i.e., it's currently a nested child of someone else),
+                            // promote it to ROOT to avoid duplicating it or deeply nesting it in multiple places.
+                            if (!existingExposure.isRoot) {
+                                // 1. Calculate new root paths (handling collisions)
+                                const targetDomEntity = domain.findEntity(target.key, target.domain);
+                                if (targetDomEntity) {
+                                    const name = targetDomEntity.info.name || '';
+                                    const segment = pluralize(name.toLocaleLowerCase());
+                                    let relativeCollectionPath = `/${segment}`;
+                                    let relativeResourcePath = `/${segment}/{id}`;
+                                    let counter = 1;
+                                    const originalCollectionPath = relativeCollectionPath;
+                                    while (this.exposes.some((e) => e.isRoot && e.collectionPath === relativeCollectionPath)) {
+                                        relativeCollectionPath = `${originalCollectionPath}-${counter}`;
+                                        relativeResourcePath = `${relativeCollectionPath}/{id}`;
+                                        counter++;
+                                    }
+                                    // 2. Update properties to make it root
+                                    existingExposure.isRoot = true;
+                                    existingExposure.parent = undefined;
+                                    existingExposure.collectionPath = relativeCollectionPath;
+                                    existingExposure.resourcePath = relativeResourcePath;
+                                    existingExposure.hasCollection = true;
+                                }
+                            }
+                            // Whether it was already root or we just promoted it, we stop following here.
+                            continue;
                         }
                         // Find the target domain entity for path generation
                         const targetDomainEntity = domain.findEntity(target.key, target.domain);
@@ -411,25 +453,28 @@ let ApiModel = (() => {
                         }
                         else {
                             // Recursively follow associations
-                            follow(target, nestedExposure.key, depth + 1);
+                            follow(target, nestedExposure.key, depth + 1, [...currentPath, targetKeys]);
                         }
                     }
                 }
             };
             // Start following from the root exposure
-            follow(parentExposure.entity, parentExposure.key, 0);
+            // Initial path contains the root entity itself
+            const rootKey = createDomainKey(parentExposure.entity);
+            follow(parentExposure.entity, parentExposure.key, 0, [rootKey]);
         }
         /**
          * Removes an exposed entity from the API model.
-         * @param entity The entity to remove.
+         * This also removes any nested exposed entities that are children of the removed entity.
+         *
+         * @param key The key of the exposed entity to remove.
          */
-        removeEntity(entity) {
-            const current = this.exposes.find((e) => e.entity.key === entity.key && e.entity.domain === entity.domain);
-            if (!current) {
-                return;
+        removeExposedEntity(key) {
+            const index = this.exposes.findIndex((e) => e.key === key);
+            if (index < 0) {
+                throw new Error(`Exposed entity with key "${key}" not found.`);
             }
-            this.removeWithChildren(current.key);
-            this.notifyChange();
+            this.removeWithChildren(key);
         }
         removeWithChildren(key) {
             const index = this.exposes.findIndex((e) => e.key === key);
@@ -463,11 +508,11 @@ let ApiModel = (() => {
             return this.exposes.find((e) => e.entity.key === entity.key && e.entity.domain === entity.domain);
         }
         /**
-         * Clears the API model for a new entity change.
+         * Clears the API model for a new data domain change.
          * This method resets the dependencies, exposes, user,
          * authentication, authorization, and session properties.
          */
-        cleanForEntityChange() {
+        cleanForDomainChange() {
             this.dependencies.clear();
             this.dependencyList = [];
             this.exposes = [];
@@ -495,7 +540,7 @@ let ApiModel = (() => {
             if (!domain.info.version) {
                 throw new Error(`Cannot attach DataDomain without a version. Please set the version in the domain info.`);
             }
-            this.cleanForEntityChange();
+            this.cleanForDomainChange();
             this.dependencies.set(domain.key, domain);
             this.dependencyList = [{ key: domain.key, version: domain.info.version }];
             this.notifyChange();