@api-client/core 0.19.23 → 0.19.25

package/src/models/store/Deployment.ts

@@ -0,0 +1,250 @@
+import type { FieldValidationMessage } from '../../exceptions/validation_error.js'
+import { nanoid } from '../../nanoid.js'
+import { DeploymentKind } from '../kinds.js'
+
+export { DeploymentKind }
+
+/**
+ * Status of the deployment
+ */
+export enum DeploymentStatus {
+  /**
+   * Deployment is pending
+   */
+  Pending = 0,
+  /**
+   * Deployment is active
+   */
+  Active = 1,
+  /**
+   * Deployment is inactive
+   */
+  Inactive = 2,
+  /**
+   * Deployment has failed
+   */
+  Failed = 3,
+}
+
+/**
+ * Environment tag for logical deployment grouping
+ */
+export enum DeploymentEnvironment {
+  PROD = 'prod',
+  STAGING = 'staging',
+  DEV = 'dev',
+}
+
+export interface DeploymentSchema {
+  kind: typeof DeploymentKind
+  /**
+   * Primary key (nanoid)
+   */
+  key: string
+  /**
+   * ID of the organization
+   */
+  orgId: string
+  /**
+   * The file ID representing the API
+   */
+  apiId: string
+  /**
+   * Denormalized organization slug
+   */
+  orgSlug: string
+  /**
+   * Denormalized API slug
+   */
+  apiSlug: string
+  /**
+   * Environment tag
+   */
+  env: DeploymentEnvironment
+  /**
+   * The version of the deployment (e.g., 'v1', 'v2')
+   * It must be set for production environments.
+   * It cannot be set for non-production environments (e.g. 'dev').
+   */
+  version?: string
+  /**
+   * The semantic version of the deployed API model (e.g., '1.0.1').
+   */
+  modelVersion: string
+  /**
+   * Status of the deployment
+   */
+  status: DeploymentStatus
+  /**
+   * Timestamp of creation
+   */
+  createdAt: number
+  /**
+   * Timestamp of last update
+   */
+  updatedAt: number
+  /**
+   * The base URI to the API.
+   * Note: This field is computed at runtime when the deployment status is active.
+   * Note: This field is ignored when creating or updating a deployment.
+   */
+  baseUri?: string
+  /**
+   * The URI to the API portal.
+   * Note: This field is computed at runtime when the deployment status is active.
+   * Note: This field is ignored when creating or updating a deployment.
+   */
+  portalUri?: string
+}
+
+export class Deployment implements DeploymentSchema {
+  readonly kind: typeof DeploymentKind = DeploymentKind
+  key: string
+  orgId: string
+  apiId: string
+  orgSlug: string
+  apiSlug: string
+  env: DeploymentEnvironment
+  version?: string
+  modelVersion: string
+  status: DeploymentStatus
+  createdAt: number
+  updatedAt: number
+  baseUri?: string
+  portalUri?: string
+
+  static createSchema(input: Partial<DeploymentSchema> = {}): DeploymentSchema {
+    const key = input.key ?? nanoid()
+    const result: DeploymentSchema = {
+      kind: DeploymentKind,
+      key,
+      orgId: input.orgId || '',
+      apiId: input.apiId || '',
+      orgSlug: input.orgSlug || '',
+      apiSlug: input.apiSlug || '',
+      env: input.env ?? DeploymentEnvironment.DEV,
+      modelVersion: input.modelVersion || '0.0.0',
+      status: input.status ?? DeploymentStatus.Pending,
+      createdAt: input.createdAt ?? Date.now(),
+      updatedAt: input.updatedAt ?? Date.now(),
+    }
+    if (input.baseUri) {
+      result.baseUri = input.baseUri
+    }
+    if (input.portalUri) {
+      result.portalUri = input.portalUri
+    }
+    if (input.version) {
+      result.version = input.version
+    }
+    return result
+  }
+
+  constructor(state?: Partial<DeploymentSchema>) {
+    const init = Deployment.createSchema(state)
+    this.key = init.key
+    this.orgId = init.orgId
+    this.apiId = init.apiId
+    this.orgSlug = init.orgSlug
+    this.apiSlug = init.apiSlug
+    this.env = init.env
+    this.version = init.version
+    this.status = init.status
+    this.createdAt = init.createdAt
+    this.updatedAt = init.updatedAt
+    this.modelVersion = init.modelVersion
+    this.baseUri = init.baseUri
+    this.portalUri = init.portalUri
+  }
+
+  toJSON(): DeploymentSchema {
+    const result: DeploymentSchema = {
+      kind: DeploymentKind,
+      key: this.key,
+      orgId: this.orgId,
+      apiId: this.apiId,
+      orgSlug: this.orgSlug,
+      apiSlug: this.apiSlug,
+      env: this.env,
+      modelVersion: this.modelVersion,
+      status: this.status,
+      createdAt: this.createdAt,
+      updatedAt: this.updatedAt,
+    }
+    if (this.version) {
+      result.version = this.version
+    }
+    if (this.baseUri) {
+      result.baseUri = this.baseUri
+    }
+    if (this.portalUri) {
+      result.portalUri = this.portalUri
+    }
+    return result
+  }
+
+  /**
+   * Validates the deployment.
+   * @returns An array of validation messages.
+   */
+  validate(): FieldValidationMessage[] {
+    const result: FieldValidationMessage[] = []
+
+    if (this.orgId === '') {
+      result.push({
+        field: 'orgId',
+        message: 'Org ID must not be empty',
+        rule: 'notEmpty',
+      })
+    }
+    if (this.apiId === '') {
+      result.push({
+        field: 'apiId',
+        message: 'API ID must not be empty',
+        rule: 'notEmpty',
+      })
+    }
+    if (this.orgSlug === '') {
+      result.push({
+        field: 'orgSlug',
+        message: 'Org slug must not be empty',
+        rule: 'notEmpty',
+      })
+    }
+    if (this.apiSlug === '') {
+      result.push({
+        field: 'apiSlug',
+        message: 'API slug must not be empty',
+        rule: 'notEmpty',
+      })
+    }
+    if (!this.env) {
+      result.push({
+        field: 'env',
+        message: 'Environment tag must not be empty',
+        rule: 'notEmpty',
+      })
+    }
+    if (this.modelVersion === '') {
+      result.push({
+        field: 'modelVersion',
+        message: 'API model version must not be empty',
+        rule: 'notEmpty',
+      })
+    }
+    if (this.env === DeploymentEnvironment.PROD && !this.version) {
+      result.push({
+        field: 'version',
+        message: 'Version must not be empty for production environment',
+        rule: 'notEmpty',
+      })
+    } else if (this.env !== DeploymentEnvironment.PROD && this.version) {
+      result.push({
+        field: 'version',
+        message: 'Version must not be present for non-production environment',
+        rule: 'notEmpty',
+      })
+    }
+    return result
+  }
+}

package/src/models/store/DeploymentCustomDomain.ts

@@ -0,0 +1,120 @@
+import type { FieldValidationMessage } from '../../exceptions/validation_error.js'
+import { nanoid } from '../../nanoid.js'
+
+export enum SslStatus {
+  Initializing = 0,
+  PendingDns = 1,
+  Issuing = 2,
+  Active = 3,
+  Error = 4,
+}
+
+export interface DeploymentCustomDomainSchema {
+  /**
+   * Primary key (nanoid)
+   */
+  id: string
+  /**
+   * ID of the deployment
+   */
+  deploymentId: string
+  /**
+   * ID of the custom domain
+   */
+  customDomainId: string
+  /**
+   * The base path for the deployment
+   */
+  basePath: string
+  /**
+   * Status of the SSL certificate
+   */
+  sslStatus: SslStatus
+  /**
+   * Timestamp of creation
+   */
+  createdAt: number
+  /**
+   * Timestamp of last update
+   */
+  updatedAt: number
+}
+
+export class DeploymentCustomDomainModel implements DeploymentCustomDomainSchema {
+  id: string
+  deploymentId: string
+  customDomainId: string
+  basePath: string
+  sslStatus: SslStatus
+  createdAt: number
+  updatedAt: number
+
+  static createSchema(input: Partial<DeploymentCustomDomainSchema> = {}): DeploymentCustomDomainSchema {
+    const id = input.id ?? nanoid()
+    return {
+      id,
+      deploymentId: input.deploymentId || '',
+      customDomainId: input.customDomainId || '',
+      basePath: input.basePath ?? '/',
+      sslStatus: input.sslStatus ?? SslStatus.PendingDns,
+      createdAt: input.createdAt ?? Date.now(),
+      updatedAt: input.updatedAt ?? Date.now(),
+    }
+  }
+
+  constructor(state?: Partial<DeploymentCustomDomainSchema>) {
+    const init = DeploymentCustomDomainModel.createSchema(state)
+    this.id = init.id
+    this.deploymentId = init.deploymentId
+    this.customDomainId = init.customDomainId
+    this.basePath = init.basePath
+    this.sslStatus = init.sslStatus
+    this.createdAt = init.createdAt
+    this.updatedAt = init.updatedAt
+  }
+
+  toJSON(): DeploymentCustomDomainSchema {
+    return {
+      id: this.id,
+      deploymentId: this.deploymentId,
+      customDomainId: this.customDomainId,
+      basePath: this.basePath,
+      sslStatus: this.sslStatus,
+      createdAt: this.createdAt,
+      updatedAt: this.updatedAt,
+    }
+  }
+
+  validate(): FieldValidationMessage[] {
+    const result: FieldValidationMessage[] = []
+
+    if (this.basePath === '') {
+      result.push({
+        field: 'basePath',
+        message: 'Base path must not be empty',
+        rule: 'notEmpty',
+      })
+    } else if (!this.basePath.startsWith('/')) {
+      result.push({
+        field: 'basePath',
+        message: 'Base path must start with a slash',
+        rule: 'startsWithSlash',
+      })
+    }
+    if (!this.deploymentId) {
+      result.push({
+        field: 'deploymentId',
+        message: 'Deployment ID must not be empty',
+        rule: 'notEmpty',
+      })
+    }
+    if (!this.customDomainId) {
+      result.push({
+        field: 'customDomainId',
+        message: 'Custom domain ID must not be empty',
+        rule: 'notEmpty',
+      })
+    }
+    return result
+  }
+}

package/src/sdk/DataCatalogSdk.ts

@@ -1,11 +1,4 @@
-import {
-  SdkBase,
-  E_RESPONSE_STATUS,
-  E_RESPONSE_NO_VALUE,
-  E_INVALID_JSON,
-  E_RESPONSE_UNKNOWN,
-  SdkOptions,
-} from './SdkBase.js'
+import { SdkBase, E_RESPONSE_STATUS, SdkOptions } from './SdkBase.js'
 import { ContextListResult, ContextListOptions, ContextChangeRecord } from '../events/BaseEvents.js'
 import type {
   DataCatalogSchema,
@@ -19,7 +12,6 @@ import { DataCatalogKind, DataCatalogVersionKind } from '../models/kinds.js'
 import type { DataCatalogVersionSchema } from '../models/DataCatalogVersion.js'
 import type { ForeignDomainDependency } from '../modeling/types.js'
 import type { DataDomainSchema } from '../modeling/DataDomain.js'
-import { Exception } from '../exceptions/exception.js'
 
 export interface DataCatalogListOptions extends ContextListOptions {
   scope?: DataCatalogScope
@@ -38,26 +30,7 @@ export class DataCatalogSdk extends SdkBase {
       url.searchParams.set('scope', opts.scope)
     }
     const result = await this.sdk.http.get(url.toString(), { token })
-    this.inspectCommonStatusCodes(result)
-    const E_PREFIX = 'Unable to list data domains. '
-    if (result.status !== 200) {
-      this.logInvalidResponse(result)
-      throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
-    }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-
-    let data: ContextListResult<DataCatalogSchemaWithVersion>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (!Array.isArray(data.items)) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
-    return data
+    return this.processListResponse<DataCatalogSchemaWithVersion>(result, 'Unable to list data domains. ')
   }
 
   /**
@@ -68,25 +41,7 @@ export class DataCatalogSdk extends SdkBase {
     const { token } = request
     const url = this.sdk.getUrl(RouteBuilder.dataCatalogEntryVersions(key))
     const result = await this.sdk.http.get(url.toString(), { token })
-    this.inspectCommonStatusCodes(result)
-    const E_PREFIX = 'Unable to list data domain versions. '
-    if (result.status !== 200) {
-      this.logInvalidResponse(result)
-      throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
-    }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: ContextListResult<DataCatalogVersionInfo>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (!Array.isArray(data.items)) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
-    return data
+    return this.processListResponse<DataCatalogVersionInfo>(result, 'Unable to list data domain versions. ')
   }
 
   /**
@@ -112,19 +67,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: ContextChangeRecord<DataCatalogSchema>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (!data.key) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogSchema>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogKind, data.kind)
     return data
   }
 
@@ -138,18 +82,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: DataCatalogSchema
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (data.kind !== DataCatalogKind) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogSchema>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogKind, data.kind)
     return data
   }
 
@@ -180,18 +114,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: ContextChangeRecord<DataCatalogSchema>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (data.kind !== DataCatalogKind) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogSchema>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogKind, data.kind)
     return data
   }
 
@@ -211,18 +135,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: ContextChangeRecord<DataCatalogSchema>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (data.kind !== DataCatalogKind) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogSchema>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogKind, data.kind)
     return data
   }
 
@@ -247,18 +161,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: ContextChangeRecord<DataCatalogVersionSchema>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (data.kind !== DataCatalogVersionKind) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogVersionSchema>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogVersionKind, data.kind)
     return data
   }
 
@@ -272,18 +176,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: DataCatalogVersionSchema
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (data.kind !== DataCatalogVersionKind) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogVersionSchema>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogVersionKind, data.kind)
     return data
   }
 
@@ -301,25 +195,7 @@ export class DataCatalogSdk extends SdkBase {
         'content-type': 'application/json',
       },
     })
-    this.inspectCommonStatusCodes(result)
-    const E_PREFIX = 'Unable to list data domain dependencies. '
-    if (result.status !== 200) {
-      this.logInvalidResponse(result)
-      throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
-    }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: ContextListResult<DataDomainSchema>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (!Array.isArray(data.items)) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
-    return data
+    return this.processListResponse<DataDomainSchema>(result, 'Unable to list data domain dependencies. ')
   }
 
   async deprecateVersion(
@@ -344,18 +220,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: ContextChangeRecord<DataCatalogVersionSchema>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (data.kind !== DataCatalogVersionKind) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogVersionSchema>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogVersionKind, data.kind)
     return data
   }
 
@@ -373,18 +239,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: ContextChangeRecord<DataCatalogVersionSchema>
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (data.kind !== DataCatalogVersionKind) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogVersionSchema>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogVersionKind, data.kind)
     return data
   }
 
@@ -408,18 +264,8 @@ export class DataCatalogSdk extends SdkBase {
       this.logInvalidResponse(result)
       throw this.createApiError(`${E_PREFIX}${E_RESPONSE_STATUS}${result.status}`, result.body)
     }
-    if (!result.body) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_NO_VALUE}`, { code: 'E_RESPONSE_NO_VALUE', status: result.status })
-    }
-    let data: DataCatalogStatus
-    try {
-      data = JSON.parse(result.body)
-    } catch {
-      throw new Exception(`${E_PREFIX}${E_INVALID_JSON}`, { code: 'E_INVALID_JSON', status: result.status })
-    }
-    if (data.kind !== DataCatalogKind) {
-      throw new Exception(`${E_PREFIX}${E_RESPONSE_UNKNOWN}`, { code: 'E_RESPONSE_UNKNOWN', status: result.status })
-    }
+    const data = this.readResponseJSON<DataCatalogStatus>(result, E_PREFIX)
+    this.assertObjectKind(E_PREFIX, DataCatalogKind, data.kind)
     return data
   }
 }