@api-client/core 0.19.17 → 0.19.19

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.19.17",
+  "version": "0.19.19",
   "license": "UNLICENSED",
   "exports": {
     "./browser.js": {

package/src/mocking/ProjectMock.ts

@@ -10,7 +10,7 @@ import { HostRules } from './lib/HostRules.js'
 
 export type { IRequestLogInit } from './lib/Request.js'
 export type { IResponseInit } from './lib/Response.js'
-export type { IUserInit } from './lib/User.js'
+export type { UserInitSchema, IUserInit } from './lib/User.js'
 export type { IHttpHistoryInit, IHttpHistoryListInit } from './lib/History.js'
 
 export class ProjectMock extends DataMock {

package/src/mocking/lib/File.ts

@@ -1,6 +1,6 @@
 import { faker } from '@faker-js/faker'
 import { ProjectKind, DomainFileKind, CertificateFileKind, FolderKind, ApiFileKind } from '../../models/kinds.js'
-import { File as CoreFile, type IFile, type FileBreadcrumb } from '../../models/store/File.js'
+import { File as CoreFile, type FileSchema, type FileBreadcrumb } from '../../models/store/File.js'
 import { nanoid } from '../../nanoid.js'
 
 export class File {
@@ -10,7 +10,7 @@ export class File {
    * @param init Optional values to be present in the object.
    * @returns Random file
    */
-  file(init: Partial<IFile> = {}): IFile {
+  file(init: Partial<FileSchema> = {}): FileSchema {
     const {
       kind = faker.helpers.arrayElement([ProjectKind, DomainFileKind, CertificateFileKind, ApiFileKind] as const),
       info = { name: faker.system.fileName() },
@@ -23,7 +23,7 @@ export class File {
    * @param size Number of files to generate. Default is 25.
    * @returns List of random files
    */
-  files(size = 25, init?: Partial<IFile>): IFile[] {
+  files(size = 25, init?: Partial<FileSchema>): FileSchema[] {
     const result = []
     for (let i = 0; i < size; i++) {
       result.push(this.file(init))
@@ -36,7 +36,7 @@ export class File {
    * @param init Optional values to be present in the object.
    * @returns Random folder
    */
-  folder(init: Partial<IFile> = {}): IFile {
+  folder(init: Partial<FileSchema> = {}): FileSchema {
     return this.file({ kind: FolderKind, ...init })
   }
 
@@ -45,7 +45,7 @@ export class File {
    * @param size Number of folders to generate. Default is 25.
    * @returns List of random folders
    */
-  folders(size = 25, init?: Partial<IFile>): IFile[] {
+  folders(size = 25, init?: Partial<FileSchema>): FileSchema[] {
     const result = []
     for (let i = 0; i < size; i++) {
       result.push(this.folder(init))

package/src/mocking/lib/Organization.ts

@@ -1,18 +1,40 @@
 import { faker } from '@faker-js/faker'
 import { OrganizationKind } from '../../models/kinds.js'
 import { nanoid } from '../../nanoid.js'
-import type { IOrganization } from '../../models/store/Organization.js'
+import type { OrganizationSchema, OrganizationSlugValidateResponse } from '../../models/store/Organization.js'
 
 export class Organization {
+  organizationSlugGenerateResponse(name?: string): { slug: string } {
+    const finalName = name ?? faker.company.name()
+    let baseSlug = faker.helpers.slugify(finalName)
+    // Truncate to ensure there's room for a suffix if needed
+    if (baseSlug.length > 55) {
+      baseSlug = baseSlug.substring(0, 55)
+    }
+    const suffix = nanoid(6).toLowerCase()
+    return { slug: `${baseSlug}-${suffix}` }
+  }
+
+  organizationSlugValidateResponse(
+    init: Partial<OrganizationSlugValidateResponse> = {}
+  ): OrganizationSlugValidateResponse {
+    const { valid = true, reason } = init
+    return {
+      valid,
+      reason,
+    }
+  }
+
   /**
    * Generates a random organization object.
    * @param init Optional values to be present in the object.
    * @returns Random organization
    */
-  organization(init: Partial<IOrganization> = {}): IOrganization {
+  organization(init: Partial<OrganizationSchema> = {}): OrganizationSchema {
     const {
       key = nanoid(),
       name = faker.company.name(),
+      slug = faker.helpers.slugify(name),
       createdBy = nanoid(),
       createdDate = faker.date.past().getTime(),
       grantType = faker.helpers.arrayElement(['owner', 'manager', 'editor', 'viewer'] as const),
@@ -21,6 +43,7 @@ export class Organization {
       kind: OrganizationKind,
       key,
       name,
+      slug,
       createdBy,
       createdDate,
       grantType,
@@ -32,7 +55,7 @@ export class Organization {
    * @param size Number of organizations to generate. Default is 25.
    * @returns List of random organizations
    */
-  organizations(size = 25, init?: Partial<IOrganization>): IOrganization[] {
+  organizations(size = 25, init?: Partial<OrganizationSchema>): OrganizationSchema[] {
     const result = []
     for (let i = 0; i < size; i++) {
       result.push(this.organization(init))

package/src/mocking/lib/Permission.ts

@@ -1,7 +1,7 @@
 import { faker } from '@faker-js/faker'
 import { nanoid } from '../../nanoid.js'
 import {
-  IPermission,
+  PermissionSchema,
   Kind as PermissionKind,
   type PermissionRole,
   type PermissionType,
@@ -14,11 +14,11 @@ export class Permission {
    * @param init Configuration options for the permission object.
    * @returns Random permission
    */
-  permission(init: Partial<IPermission> = {}): IPermission {
+  permission(init: Partial<PermissionSchema> = {}): PermissionSchema {
     const type = init.type ?? faker.helpers.arrayElement(['user', 'group', 'organization'] as PermissionType[])
     const role = init.role ?? faker.helpers.arrayElement(['reader', 'commenter', 'writer', 'owner'] as PermissionRole[])
 
-    const result: IPermission = {
+    const result: PermissionSchema = {
       kind: PermissionKind,
       key: init.key ?? nanoid(),
       type,
@@ -62,7 +62,7 @@ export class Permission {
    * @param init Configuration options for the permission object.
    * @returns Random user permission
    */
-  userPermission(init: Partial<IPermission> = {}): IPermission {
+  userPermission(init: Partial<PermissionSchema> = {}): PermissionSchema {
     return this.permission({ ...init, type: 'user' })
   }
 
@@ -71,7 +71,7 @@ export class Permission {
    * @param init Configuration options for the permission object.
    * @returns Random group permission
    */
-  groupPermission(init: Partial<IPermission> = {}): IPermission {
+  groupPermission(init: Partial<PermissionSchema> = {}): PermissionSchema {
     return this.permission({ ...init, type: 'group' })
   }
 
@@ -80,7 +80,7 @@ export class Permission {
    * @param init Configuration options for the permission object.
    * @returns Random organization permission
    */
-  organizationPermission(init: Partial<IPermission> = {}): IPermission {
+  organizationPermission(init: Partial<PermissionSchema> = {}): PermissionSchema {
     return this.permission({ ...init, type: 'organization' })
   }
 
@@ -90,8 +90,8 @@ export class Permission {
    * @param init Configuration options for the permission object.
    * @returns List of random permissions
    */
-  permissions(size = 25, init: Partial<IPermission> = {}): IPermission[] {
-    const result: IPermission[] = []
+  permissions(size = 25, init: Partial<PermissionSchema> = {}): PermissionSchema[] {
+    const result: PermissionSchema[] = []
     for (let i = 0; i < size; i++) {
       result.push(this.permission(init))
     }

package/src/mocking/lib/User.ts

@@ -1,21 +1,26 @@
 import { faker } from '@faker-js/faker'
 import { nanoid } from '../../nanoid.js'
-import { IUser, Kind as UserKind } from '../../models/store/User.js'
+import { UserSchema, Kind as UserKind } from '../../models/store/User.js'
 
-export interface IUserInit {
+export interface UserInitSchema {
   noEmail?: boolean
   noPicture?: boolean
   noProvider?: boolean
 }
 
+/**
+ * @deprecated Use {@link UserInitSchema} instead.
+ */
+export type IUserInit = UserInitSchema
+
 export class User {
   /**
    * Generates a random user object.
    * @param init Configuration options for the user object.
    * @returns Random user
    */
-  user(init: IUserInit = {}): IUser {
-    const result: IUser = {
+  user(init: UserInitSchema = {}): UserSchema {
+    const result: UserSchema = {
       kind: UserKind,
       key: nanoid(),
       name: faker.person.fullName(),
@@ -51,8 +56,8 @@ export class User {
    * @param init Configuration options for the user object.
    * @returns List of random users
    */
-  users(size = 25, init: IUserInit = {}): IUser[] {
-    const result: IUser[] = []
+  users(size = 25, init: UserInitSchema = {}): UserSchema[] {
+    const result: UserSchema[] = []
     for (let i = 0; i < size; i++) {
       result.push(this.user(init))
     }

package/src/modeling/ApiFile.ts

@@ -1,11 +1,16 @@
-import { File, type IFile } from '../models/store/File.js'
+import { File, type FileSchema } from '../models/store/File.js'
 import { ApiFileKind } from '../models/kinds.js'
 import { ApiModel, ApiModelSchema } from './ApiModel.js'
 
-export interface IApiFile extends IFile {
+export interface ApiFileSchema extends FileSchema {
   kind: typeof ApiFileKind
 }
 
+/**
+ * @deprecated Use {@link ApiFileSchema} instead.
+ */
+export type IApiFile = ApiFileSchema
+
 /**
  * Used by the store. A file definition for the ApiModel.
  */
@@ -31,20 +36,20 @@ export class ApiFile extends File {
     return new ApiFile({ key: final.key, info: final.info })
   }
 
-  constructor(state: Partial<IApiFile> = {}) {
+  constructor(state: Partial<ApiFileSchema> = {}) {
     super({ ...state, kind: ApiFileKind })
   }
 
   static isApiFile(input: unknown): boolean {
-    const typed = input as IApiFile
+    const typed = input as ApiFileSchema
     if (!input || typed.kind !== ApiFileKind) {
       return false
     }
     return true
   }
 
-  override toJSON(): IApiFile {
-    const result: IApiFile = {
+  override toJSON(): ApiFileSchema {
+    const result: ApiFileSchema = {
       ...super.toJSON(),
       kind: ApiFileKind,
     }

package/src/modeling/ApiModel.ts

@@ -1,6 +1,6 @@
 import { nanoid } from '../nanoid.js'
 import { ApiModelKind, DataDomainKind, ExposedEntityKind } from '../models/kinds.js'
-import { type IThing, Thing } from '../models/Thing.js'
+import { type ThingSchema, Thing } from '../models/Thing.js'
 import type {
   AssociationTarget,
   AuthenticationConfiguration,
@@ -66,7 +66,7 @@ export interface ApiModelSchema extends DependentModelSchema {
   /**
    * Contains the name, display name, description, and the version of the API model schema.
    */
-  info: IThing
+  info: ThingSchema
 
   /**
    * The designated Data Entity that represents a "User".

package/src/modeling/DataDomain.ts

@@ -23,13 +23,13 @@ import { type DomainModelSchema, DomainModel } from './DomainModel.js'
 import { type DomainEntitySchema, DomainEntity } from './DomainEntity.js'
 import { DomainAssociation, DomainAssociationSchema } from './DomainAssociation.js'
 import { DomainProperty, DomainPropertySchema } from './DomainProperty.js'
-import { type IThing, Thing } from '../models/Thing.js'
+import { type ThingSchema, Thing } from '../models/Thing.js'
 import { removeGraphNode } from './GraphUtils.js'
 import { serialize, deserialize, mergeGraph, removeForeignGraph } from './DomainSerialization.js'
 import { DependentModel, type DependentModelSchema, type DomainDependency } from './DependentModel.js'
 
 export interface DataDomainSchema extends DependentModelSchema {
-  info: IThing
+  info: ThingSchema
   kind: typeof DataDomainKind
   key: string
   graph?: SerializedGraph

package/src/modeling/DomainAssociation.ts

@@ -2,7 +2,7 @@ import type { DataDomain } from './DataDomain.js'
 import { DomainAssociationKind } from '../models/kinds.js'
 import { DomainElement, type DomainElementSchema } from './DomainElement.js'
 import { nanoid } from '../nanoid.js'
-import { type IThing, Thing } from '../models/Thing.js'
+import { type ThingSchema, Thing } from '../models/Thing.js'
 import { observed, retargetChange, toRaw } from '../decorators/observed.js'
 import type { DomainEntity } from './DomainEntity.js'
 import type { Shapes } from '@api-client/amf-core'
@@ -37,7 +37,7 @@ export interface DomainAssociationSchema extends DomainElementSchema {
   /**
    * The data association description.
    */
-  info: IThing
+  info: ThingSchema
   /**
    * Wether the data association is required.
    */

package/src/modeling/DomainEntity.ts

@@ -2,7 +2,7 @@ import type { DataDomain } from './DataDomain.js'
 import { DomainAssociationKind, DomainEntityKind, DomainPropertyKind } from '../models/kinds.js'
 import { DomainElement, type DomainElementSchema } from './DomainElement.js'
 import { nanoid } from '../nanoid.js'
-import { type IThing, Thing } from '../models/Thing.js'
+import { type ThingSchema, Thing } from '../models/Thing.js'
 import { observed, retargetChange, toRaw } from '../decorators/observed.js'
 import type { Shapes, IShapeRenderOptions } from '@api-client/amf-core'
 import { ApiSchemaGenerator } from '@api-client/amf-core'
@@ -34,7 +34,7 @@ export interface DomainEntitySchema extends DomainElementSchema {
   /**
    * The domain entity description.
    */
-  info: IThing
+  info: ThingSchema
 
   /**
    * Optional general purpose tags for the UI.

package/src/modeling/DomainFile.ts

@@ -1,11 +1,16 @@
-import { File, type IFile } from '../models/store/File.js'
+import { File, type FileSchema } from '../models/store/File.js'
 import type { DataDomain, DataDomainSchema } from './DataDomain.js'
 import { DomainFileKind } from '../models/kinds.js'
 
-export interface IDomainFile extends IFile {
+export interface DomainFileSchema extends FileSchema {
   kind: typeof DomainFileKind
 }
 
+/**
+ * @deprecated Use {@link DomainFileSchema} instead.
+ */
+export type IDomainFile = DomainFileSchema
+
 /**
  * Used by the store. A file definition for the DataDomain
  */
@@ -31,20 +36,20 @@ export class DomainFile extends File {
     return new DomainFile({ key: final.key, info: final.info })
   }
 
-  constructor(state: Partial<IDomainFile> = {}) {
+  constructor(state: Partial<DomainFileSchema> = {}) {
     super({ ...state, kind: DomainFileKind })
   }
 
   static isDomainFile(input: unknown): boolean {
-    const typed = input as IDomainFile
+    const typed = input as DomainFileSchema
     if (!input || typed.kind !== DomainFileKind) {
       return false
     }
     return true
   }
 
-  override toJSON(): IDomainFile {
-    const result: IDomainFile = {
+  override toJSON(): DomainFileSchema {
+    const result: DomainFileSchema = {
       ...super.toJSON(),
       kind: DomainFileKind,
     }

package/src/modeling/DomainModel.ts

@@ -2,7 +2,7 @@ import type { DataDomain } from './DataDomain.js'
 import { DomainEntityKind, DomainModelKind } from '../models/kinds.js'
 import { DomainElement, DomainElementSchema } from './DomainElement.js'
 import { nanoid } from '../nanoid.js'
-import { type IThing, Thing } from '../models/Thing.js'
+import { type ThingSchema, Thing } from '../models/Thing.js'
 import { observed, retargetChange } from '../decorators/observed.js'
 import type { DomainNamespace } from './DomainNamespace.js'
 import type { FileBreadcrumb } from '../models/store/File.js'
@@ -29,7 +29,7 @@ export interface DomainModelSchema extends DomainElementSchema {
   /**
    * The data model description.
    */
-  info: IThing
+  info: ThingSchema
   /**
    * The ordered list of entities in the schema.
    */

package/src/modeling/DomainNamespace.ts

@@ -2,7 +2,7 @@ import type { DataDomain } from './DataDomain.js'
 import { DomainModelKind, DomainNamespaceKind } from '../models/kinds.js'
 import { DomainElement, DomainElementSchema } from './DomainElement.js'
 import { nanoid } from '../nanoid.js'
-import { IThing, Thing } from '../models/Thing.js'
+import { ThingSchema, Thing } from '../models/Thing.js'
 import { observed, retargetChange } from '../decorators/observed.js'
 import { DomainModel, DomainModelSchema } from './DomainModel.js'
 import { RemoveNamespaceException } from '../exceptions/remove_namespace_exception.js'
@@ -28,7 +28,7 @@ export interface DomainNamespaceSchema extends DomainElementSchema {
   /**
    * The data namespace description.
    */
-  info: IThing
+  info: ThingSchema
   /**
    * The ordered list of fields (namespace and models) in the schema.
    * These only keep references to define the order of these properties

package/src/modeling/DomainProperty.ts

@@ -2,7 +2,7 @@ import type { DataDomain } from './DataDomain.js'
 import { DomainPropertyKind } from '../models/kinds.js'
 import { DomainElement, type DomainElementSchema } from './DomainElement.js'
 import { nanoid } from '../nanoid.js'
-import { type IThing, Thing } from '../models/Thing.js'
+import { type ThingSchema, Thing } from '../models/Thing.js'
 import { observed, retargetChange, toRaw } from '../decorators/observed.js'
 import {
   type BinaryFormat,
@@ -30,7 +30,7 @@ export interface DomainPropertySchema extends DomainElementSchema {
   /**
    * The domain property description.
    */
-  info: IThing
+  info: ThingSchema
   /**
    * Wether the data property is required.
    */