@api-client/core 0.18.0 → 0.18.2

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

@@ -42071,15 +42071,15 @@
 "@id": "#197"
 },
 {
-"@id": "#206"
-},
-{
 "@id": "#200"
 },
 {
 "@id": "#203"
 },
 {
+"@id": "#206"
+},
+{
 "@id": "#209"
 }
 ],
@@ -43499,7 +43499,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: 'J'\ndescription: 'Information and communication'\n",
+"doc:raw": "class: '3'\ndescription: '150 - 300'\nnumberOfFte: 5500\nnumberOfEmployees: 5232\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43520,7 +43520,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "code: '7487'\ndescription: 'Financial and insurance activities'\ntype: \"PRIMARY\"\nclassificationCode: 'BE_NACEBEL2008'\nactivityGroupCode: 'ABCDE'\n",
+"doc:raw": "code: 'J'\ndescription: 'Information and communication'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -43541,7 +43541,7 @@
 "doc:ExternalDomainElement",
 "doc:DomainElement"
 ],
-"doc:raw": "class: '3'\ndescription: '150 - 300'\nnumberOfFte: 5500\nnumberOfEmployees: 5232\n",
+"doc:raw": "code: '7487'\ndescription: 'Financial and insurance activities'\ntype: \"PRIMARY\"\nclassificationCode: 'BE_NACEBEL2008'\nactivityGroupCode: 'ABCDE'\n",
 "core:mediaType": "application/yaml",
 "sourcemaps:sources": [
 {
@@ -44771,17 +44771,17 @@
 {
 "@id": "#202/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#202",
-"sourcemaps:value": "[(1,0)-(3,0)]"
+"sourcemaps:value": "[(1,0)-(5,0)]"
 },
 {
 "@id": "#205/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#205",
-"sourcemaps:value": "[(1,0)-(6,0)]"
+"sourcemaps:value": "[(1,0)-(3,0)]"
 },
 {
 "@id": "#208/source-map/lexical/element_0",
 "sourcemaps:element": "amf://id#208",
-"sourcemaps:value": "[(1,0)-(5,0)]"
+"sourcemaps:value": "[(1,0)-(6,0)]"
 },
 {
 "@id": "#223/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.0",
+  "version": "0.18.2",
   "license": "Apache-2.0",
   "exports": {
     "./browser.js": {

package/src/modeling/ApiModel.ts

@@ -12,7 +12,40 @@ import type {
   UsernamePasswordConfiguration,
 } from './types.js'
 import { DataDomain } from './DataDomain.js'
-import { DependentModel, type DomainDependency, type DependentModelSchema } from './DependentModel.js'
+import { DependentModel, type DependentModelSchema, type DomainDependency } from './DependentModel.js'
+import { observed, toRaw } from './observed.js'
+
+/**
+ * Contact information for the exposed API.
+ */
+export interface ApiContact {
+  /**
+   * The identifying name of the contact person/organization.
+   */
+  name?: string
+  /**
+   * The URL pointing to the contact information. MUST be in the format of a URL.
+   */
+  url?: string
+  /**
+   * The email address of the contact person/organization. MUST be in the format of an email address.
+   */
+  email?: string
+}
+
+/**
+ * License information for the exposed API.
+ */
+export interface ApiLicense {
+  /**
+   * The license name used for the API. It is recommended to be an SPDX license identifier.
+   */
+  name: string
+  /**
+   * A URL to the license used for the API. MUST be in the format of a URL.
+   */
+  url?: string
+}
 
 export interface ApiModelSchema extends DependentModelSchema {
   /**
@@ -74,6 +107,18 @@ export interface ApiModelSchema extends DependentModelSchema {
    * Defines rules to protect the API from overuse.
    */
   rateLimiting?: RateLimitingConfiguration
+  /**
+   * A URL to the Terms of Service for the API.
+   */
+  termsOfService?: string
+  /**
+   * The contact information for the exposed API.
+   */
+  contact?: ApiContact
+  /**
+   * The license information for the API.
+   */
+  license?: ApiLicense
 }
 
 export class ApiModel extends DependentModel {
@@ -135,6 +180,18 @@ export class ApiModel extends DependentModel {
    * Defines rules to protect the API from overuse.
    */
   rateLimiting?: RateLimitingConfiguration
+  /**
+   * A URL to the Terms of Service for the API.
+   */
+  @observed() accessor termsOfService: string | undefined
+  /**
+   * The contact information for the exposed API.
+   */
+  @observed({ deep: true }) accessor contact: ApiContact | undefined
+  /**
+   * The license information for the API.
+   */
+  @observed({ deep: true }) accessor license: ApiLicense | undefined
 
   /**
    * When the initializing flag is set to true,
@@ -196,6 +253,15 @@ export class ApiModel extends DependentModel {
     if (input.rateLimiting) {
       result.rateLimiting = input.rateLimiting
     }
+    if (input.termsOfService) {
+      result.termsOfService = input.termsOfService
+    }
+    if (input.contact) {
+      result.contact = structuredClone(input.contact)
+    }
+    if (input.license) {
+      result.license = structuredClone(input.license)
+    }
     return result
   }
 
@@ -234,6 +300,15 @@ export class ApiModel extends DependentModel {
     if (init.rateLimiting) {
       this.rateLimiting = structuredClone(init.rateLimiting)
     }
+    if (init.termsOfService) {
+      this.termsOfService = init.termsOfService
+    }
+    if (init.contact) {
+      this.contact = init.contact
+    }
+    if (init.license) {
+      this.license = init.license
+    }
     this.#initializing = false
     this.info.addEventListener('change', () => {
       this.notifyChange()
@@ -268,6 +343,15 @@ export class ApiModel extends DependentModel {
     if (this.rateLimiting) {
       result.rateLimiting = structuredClone(this.rateLimiting)
     }
+    if (this.termsOfService) {
+      result.termsOfService = this.termsOfService
+    }
+    if (this.contact) {
+      result.contact = structuredClone(toRaw(this, this.contact))
+    }
+    if (this.license) {
+      result.license = structuredClone(toRaw(this, this.license))
+    }
     return result
   }
 

package/src/models/DataCatalog.ts

@@ -1,3 +1,4 @@
+import type { DataCatalogLifecycle } from './DataCatalogVersion.js'
 import { DataCatalogKind } from './kinds.js'
 
 export type DataCatalogScope = 'public' | 'private' | 'organization'
@@ -102,6 +103,17 @@ export interface DataCatalogSchema {
   tags: string[]
 }
 
+export interface DataCatalogSchemaVersion {
+  /**
+   * The version of the data catalog entry.
+   */
+  version: string
+  /**
+   * The lifecycle of the data catalog version.
+   */
+  lifecycle: DataCatalogLifecycle
+}
+
 /**
  * Used with API communication when listing data catalog entries.
  */
@@ -110,7 +122,7 @@ export interface DataCatalogSchemaWithVersion extends DataCatalogSchema {
    * The list of published versions of the data catalog entry.
    * Note, this is limited to the last 20 versions.
    */
-  versions: string[]
+  versions: DataCatalogSchemaVersion[]
 }
 
 export interface DataCatalogVersionInfo {

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

@@ -6,6 +6,8 @@ import {
   type RolesBasedAccessControl,
   type ApiModelSchema,
   type ExposedEntity,
+  type ApiContact,
+  type ApiLicense,
 } from '../../../src/index.js'
 
 test.group('ApiModel.createSchema()', (g) => {
@@ -26,6 +28,9 @@ test.group('ApiModel.createSchema()', (g) => {
     assert.isUndefined(schema.session)
     assert.isUndefined(schema.accessRule)
     assert.isUndefined(schema.rateLimiting)
+    assert.isUndefined(schema.termsOfService)
+    assert.isUndefined(schema.contact)
+    assert.isUndefined(schema.license)
   })
 
   test('creates a schema with provided values', ({ assert }) => {
@@ -40,6 +45,9 @@ test.group('ApiModel.createSchema()', (g) => {
       session: { secret: 'secret', properties: ['email'] },
       accessRule: [{ type: 'public' }],
       rateLimiting: { rules: [] },
+      termsOfService: 'https://example.com/terms',
+      contact: { name: 'John Doe', email: 'john.doe@example.com' } as ApiContact,
+      license: { name: 'MIT', url: 'https://opensource.org/licenses/MIT' } as ApiLicense,
     }
     const schema = ApiModel.createSchema(input)
 
@@ -54,6 +62,9 @@ test.group('ApiModel.createSchema()', (g) => {
     assert.deepEqual(schema.session, { secret: 'secret', properties: ['email'] })
     assert.deepEqual(schema.accessRule, [{ type: 'public' }])
     assert.deepEqual(schema.rateLimiting, { rules: [] })
+    assert.equal(schema.termsOfService, 'https://example.com/terms')
+    assert.deepEqual(schema.contact, { name: 'John Doe', email: 'john.doe@example.com' })
+    assert.deepEqual(schema.license, { name: 'MIT', url: 'https://opensource.org/licenses/MIT' })
   })
 
   test('creates a schema with partial info', ({ assert }) => {
@@ -85,6 +96,9 @@ test.group('ApiModel.constructor()', (g) => {
     assert.isUndefined(model.session)
     assert.isUndefined(model.accessRule)
     assert.isUndefined(model.rateLimiting)
+    assert.isUndefined(model.termsOfService)
+    assert.isUndefined(model.contact)
+    assert.isUndefined(model.license)
     assert.deepEqual(model.dependencyList, [])
   })
 
@@ -101,6 +115,9 @@ test.group('ApiModel.constructor()', (g) => {
       session: { secret: 'secret', properties: ['email'] },
       accessRule: [{ type: 'public' }],
       rateLimiting: { rules: [] },
+      termsOfService: 'https://example.com/terms',
+      contact: { name: 'John Doe', email: 'john.doe@example.com' },
+      license: { name: 'MIT', url: 'https://opensource.org/licenses/MIT' },
     }
     const model = new ApiModel(schema)
 
@@ -114,6 +131,9 @@ test.group('ApiModel.constructor()', (g) => {
     assert.deepEqual(model.session, { secret: 'secret', properties: ['email'] })
     assert.deepEqual(model.accessRule, [{ type: 'public' }])
     assert.deepEqual(model.rateLimiting, { rules: [] })
+    assert.equal(model.termsOfService, 'https://example.com/terms')
+    assert.deepEqual(model.contact, { name: 'John Doe', email: 'john.doe@example.com' })
+    assert.deepEqual(model.license, { name: 'MIT', url: 'https://opensource.org/licenses/MIT' })
   })
 
   test('creates an instance with a DataDomain', ({ assert }) => {
@@ -159,6 +179,9 @@ test.group('ApiModel.toJSON()', (g) => {
     assert.isUndefined(json.session)
     assert.isUndefined(json.accessRule)
     assert.isUndefined(json.rateLimiting)
+    assert.isUndefined(json.termsOfService)
+    assert.isUndefined(json.contact)
+    assert.isUndefined(json.license)
   })
 
   test('serializes all provided values', ({ assert }) => {
@@ -174,6 +197,9 @@ test.group('ApiModel.toJSON()', (g) => {
       session: { secret: 'secret', properties: ['email'] },
       accessRule: [{ type: 'public' }],
       rateLimiting: { rules: [] },
+      termsOfService: 'https://example.com/terms',
+      contact: { name: 'John Doe', email: 'john.doe@example.com' },
+      license: { name: 'MIT', url: 'https://opensource.org/licenses/MIT' },
     }
     const model = new ApiModel(schema)
     const json = model.toJSON()
@@ -188,6 +214,9 @@ test.group('ApiModel.toJSON()', (g) => {
     assert.deepEqual(json.session, { secret: 'secret', properties: ['email'] })
     assert.deepEqual(json.accessRule, [{ type: 'public' }])
     assert.deepEqual(json.rateLimiting, { rules: [] })
+    assert.equal(json.termsOfService, 'https://example.com/terms')
+    assert.deepEqual(json.contact, { name: 'John Doe', email: 'john.doe@example.com' })
+    assert.deepEqual(json.license, { name: 'MIT', url: 'https://opensource.org/licenses/MIT' })
   })
 })