@api-client/core 0.18.1 → 0.18.2

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.1",
+  "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/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' })
   })
 })