@shapediver/sdk.geometry-api-sdk-v2 1.10.0 → 1.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shapediver/sdk.geometry-api-sdk-v2",
-  "version": "1.10.0",
+  "version": "1.12.0",
   "description": "SDK to communicate with the Geometry API version 2",
   "keywords": [
     "shapediver",
@@ -47,14 +47,14 @@
   },
   "devDependencies": {
     "jest": "~29.7.0",
-    "lerna": "8.1.3",
-    "typescript": "~5.5.2",
-    "webpack": "~5.92.1",
+    "lerna": "8.1.8",
+    "typescript": "~5.5.4",
+    "webpack": "~5.94.0",
     "webpack-cli": "~5.1.4",
     "webpack-dev-server": "~5.0.4"
   },
   "dependencies": {
-    "@shapediver/sdk.geometry-api-sdk-core": "~1.4.1",
-    "@shapediver/api.geometry-api-dto-v2": "~1.22.0"
+    "@shapediver/sdk.geometry-api-sdk-core": "~1.5.0",
+    "@shapediver/api.geometry-api-dto-v2": "~1.23.0"
   }
 }

package/src/ShapeDiverSdk.ts

@@ -15,6 +15,7 @@ import { ShapeDiverSessionApi } from "./resources/ShapeDiverSessionApi";
 import { ShapeDiverSystemApi } from "./resources/ShapeDiverSystemApi";
 import { ShapeDiverTextureApi } from "./resources/ShapeDiverTextureApi";
 import { ShapeDiverUtilsApi } from "./resources/ShapeDiverUtilsApi";
+import { ShapeDiverModelStateApi } from "./resources/ShapeDiverModelStateApi";
 
 export function create(baseUrl: string, jwt?: string): ShapeDiverSdk {
   return new ShapeDiverSdk(baseUrl, jwt);
@@ -28,6 +29,7 @@ export class ShapeDiverSdk extends BaseShapeDiverSdk {
   private readonly _file: ShapeDiverFileApi;
   private readonly _gltf: ShapeDiverGltfApi;
   private readonly _model: ShapeDiverModelApi;
+  private readonly _modelState: ShapeDiverModelStateApi;
   private readonly _output: ShapeDiverOutputApi;
   private readonly _sdtf: ShapeDiverSdtfApi;
   private readonly _session: ShapeDiverSessionApi;
@@ -52,6 +54,7 @@ export class ShapeDiverSdk extends BaseShapeDiverSdk {
     this._file = new ShapeDiverFileApi(this.sdkApi);
     this._gltf = new ShapeDiverGltfApi(this.sdkApi);
     this._model = new ShapeDiverModelApi(this.sdkApi);
+    this._modelState = new ShapeDiverModelStateApi(this.sdkApi);
     this._output = new ShapeDiverOutputApi(this.sdkApi);
     this._sdtf = new ShapeDiverSdtfApi(this.sdkApi);
     this._session = new ShapeDiverSessionApi(this.sdkApi);
@@ -88,6 +91,10 @@ export class ShapeDiverSdk extends BaseShapeDiverSdk {
     return this._model;
   }
 
+  get modelState(): ShapeDiverModelStateApi {
+    return this._modelState;
+  }
+
   get output(): ShapeDiverOutputApi {
     return this._output;
   }

package/src/resources/ShapeDiverAnalyticsApi.ts

@@ -27,6 +27,7 @@ export class ShapeDiverAnalyticsApi extends BaseResourceApi {
         (
           await this.api.put<ShapeDiverResponseDto>(
             this.buildAnalyticsUri() + "/session/model",
+            undefined,
             body,
           )
         )[1],
@@ -42,6 +43,7 @@ export class ShapeDiverAnalyticsApi extends BaseResourceApi {
         (
           await this.api.put<ShapeDiverResponseDto>(
             this.buildAnalyticsUri() + "/credit-metrics",
+            undefined,
             body,
           )
         )[1],
@@ -54,10 +56,7 @@ export class ShapeDiverAnalyticsApi extends BaseResourceApi {
       async () =>
         (
           await this.api.get<ShapeDiverResponseDto>(
-            this.buildAnalyticsUri() +
-              "/credit-metrics/timestamp/" +
-              timestamp +
-              "/user",
+            `${this.buildAnalyticsUri()}/credit-metrics/timestamp/${timestamp}/user`,
           )
         )[1],
     );
@@ -71,10 +70,7 @@ export class ShapeDiverAnalyticsApi extends BaseResourceApi {
       async () =>
         (
           await this.api.get<ShapeDiverResponseDto>(
-            this.buildAnalyticsUri() +
-              "/credit-metrics/timestamp/" +
-              timestamp +
-              "/org",
+            `${this.buildAnalyticsUri()}/credit-metrics/timestamp/${timestamp}/org`,
           )
         )[1],
     );
@@ -89,11 +85,7 @@ export class ShapeDiverAnalyticsApi extends BaseResourceApi {
       async () =>
         (
           await this.api.get<ShapeDiverResponseDto>(
-            this.buildAnalyticsUri() +
-              "/credit-metrics/timestamp/" +
-              timestamp +
-              "/user/" +
-              userId,
+            `${this.buildAnalyticsUri()}/credit-metrics/timestamp/${timestamp}/user/${userId}`,
           )
         )[1],
     );
@@ -108,11 +100,7 @@ export class ShapeDiverAnalyticsApi extends BaseResourceApi {
       async () =>
         (
           await this.api.get<ShapeDiverResponseDto>(
-            this.buildAnalyticsUri() +
-              "/credit-metrics/timestamp/" +
-              timestamp +
-              "/org/" +
-              orgId,
+            `${this.buildAnalyticsUri()}/credit-metrics/timestamp/${timestamp}/org/${orgId}`,
           )
         )[1],
     );

package/src/resources/ShapeDiverArSceneApi.ts

@@ -13,14 +13,14 @@ export class ShapeDiverArSceneApi extends BaseResourceApi {
 
   /**
    * Checks the existence of the specific AR scene.
-   * @param sceneId
+   * @param id AR scene ID or Model-State ID.
    * @returns `true` when the AR scene exists, otherwise `false`.
    */
-  async exists(sceneId: string): Promise<boolean> {
+  async exists(id: string): Promise<boolean> {
     return await sendRequest(async () => {
       try {
         const [_, status] = await this.api.head(
-          `${this.buildArSceneUri()}/${sceneId}`,
+          `${this.buildArSceneUri()}/${id}`,
           { disableAuthorization: true },
         );
         return status === 200;
@@ -36,13 +36,14 @@ export class ShapeDiverArSceneApi extends BaseResourceApi {
   /**
    * Download the glTF file of the specified AR scene.
    *
-   * @param sceneId - The ID of the AR scene.
+   * @param id AR scene ID or Model-State ID.
    * @returns Array of size 2: [0] = content data, [1] = content type
    */
-  async getGltf(sceneId: string): Promise<[ArrayBuffer, string]> {
+  async getGltf(id: string): Promise<[ArrayBuffer, string]> {
     return await sendRequest(async () => {
       const [header, data] = await this.api.get<ArrayBuffer>(
-        `${this.buildArSceneUri()}/${sceneId}/gltf`,
+        `${this.buildArSceneUri()}/${id}/gltf`,
+        undefined,
         {
           responseType: ShapeDiverSdkApiResponseType.DATA,
           disableAuthorization: true,
@@ -56,13 +57,14 @@ export class ShapeDiverArSceneApi extends BaseResourceApi {
   /**
    * Download the USDZ file of the specified AR scene.
    *
-   * @param sceneId - The ID of the AR scene.
+   * @param id AR scene ID or Model-State ID.
    * @returns Array of size 2: [0] = content data, [1] = content type
    */
-  async getUsdz(sceneId: string): Promise<[ArrayBuffer, string]> {
+  async getUsdz(id: string): Promise<[ArrayBuffer, string]> {
     return await sendRequest(async () => {
       const [header, data] = await this.api.get<ArrayBuffer>(
-        `${this.buildArSceneUri()}/${sceneId}/usdz`,
+        `${this.buildArSceneUri()}/${id}/usdz`,
+        undefined,
         {
           responseType: ShapeDiverSdkApiResponseType.DATA,
           disableAuthorization: true,

package/src/resources/ShapeDiverAssetApi.ts

@@ -15,6 +15,9 @@ const cdnAssetExportUri = /.+\/cdn-asset-exports\/.+/;
 const cdnAssetOutputUri = /.+\/cdn-asset-outputs\/.+/;
 const cdnAssetTextureUri = /.+\/cdn-asset-textures\/.+/;
 
+const directDownloadUri =
+  /^(http[s]?:\/\/)?(viewer|textures|downloads)\.shapediver\.com(\/.*)?$/;
+
 export class ShapeDiverAssetApi extends BaseResourceApi {
   constructor(api: ShapeDiverSdkApi) {
     super(api);
@@ -33,6 +36,7 @@ export class ShapeDiverAssetApi extends BaseResourceApi {
     return await sendRequest(async () => {
       const [header, data] = await this.api.get<ArrayBuffer>(
         `${this.buildSessionUri(sessionId)}/export/${assetData}`,
+        undefined,
         { responseType: ShapeDiverSdkApiResponseType.DATA },
       );
       const contentType = header["Content-Type"] ?? header["content-type"];
@@ -53,6 +57,7 @@ export class ShapeDiverAssetApi extends BaseResourceApi {
     return await sendRequest(async () => {
       const [header, data] = await this.api.get<ArrayBuffer>(
         `${this.buildSessionUri(sessionId)}/output/${assetData}`,
+        undefined,
         { responseType: ShapeDiverSdkApiResponseType.DATA },
       );
       const contentType = header["Content-Type"] ?? header["content-type"];
@@ -75,6 +80,7 @@ export class ShapeDiverAssetApi extends BaseResourceApi {
         (
           await this.api.get<ArrayBuffer>(
             `${this.buildSessionUri(sessionId)}/output/${assetData}`,
+            undefined,
             {
               responseType: ShapeDiverSdkApiResponseType.JSON,
               accept: "model/vnd.sdtf+json",
@@ -97,6 +103,7 @@ export class ShapeDiverAssetApi extends BaseResourceApi {
     return await sendRequest(async () => {
       const [header, data] = await this.api.get<ArrayBuffer>(
         `${this.buildSessionUri(sessionId)}/texture/${assetData}`,
+        undefined,
         { responseType: ShapeDiverSdkApiResponseType.DATA },
       );
       const contentType = header["Content-Type"] ?? header["content-type"];
@@ -116,6 +123,7 @@ export class ShapeDiverAssetApi extends BaseResourceApi {
         (
           await this.api.get<ArrayBuffer>(
             `${this.buildSessionUri(sessionId)}/gltf/${assetData}`,
+            undefined,
             { responseType: ShapeDiverSdkApiResponseType.DATA },
           )
         )[1],
@@ -134,6 +142,7 @@ export class ShapeDiverAssetApi extends BaseResourceApi {
         (
           await this.api.get<ArrayBuffer>(
             `${this.buildSessionUri(sessionId)}/usdz/${assetData}`,
+            undefined,
             { responseType: ShapeDiverSdkApiResponseType.DATA },
           )
         )[1],
@@ -151,21 +160,31 @@ export class ShapeDiverAssetApi extends BaseResourceApi {
     sessionId: string,
     url: string,
   ): Promise<[ArrayBuffer, string]> {
-    let targetUrl: string;
+    let targetUrl: string, queries: string[];
 
-    if (apiAssetTextureUri.test(url) || cdnAssetTextureUri.test(url)) {
+    if (
+      apiAssetTextureUri.test(url) ||
+      cdnAssetTextureUri.test(url) ||
+      directDownloadUri.test(url)
+    ) {
       // Call ShapeDiver texture-asset URLs directly
       targetUrl = url;
+      queries = [];
     } else {
       // All other source URLs are called via the download-image endpoint
-      targetUrl = `${this.buildSessionUri(sessionId)}/image?url=${encodeBase64(url)}`;
+      targetUrl = `${this.buildSessionUri(sessionId)}/image`;
+      queries = [`url=${encodeBase64(url)}`];
     }
 
     return await sendRequest(async () => {
-      const [header, data] = await this.api.get<ArrayBuffer>(targetUrl, {
-        responseType: ShapeDiverSdkApiResponseType.DATA,
-        disableAuthorization: cdnAssetUri.test(url), // disable for CDN URLs
-      });
+      const [header, data] = await this.api.get<ArrayBuffer>(
+        targetUrl,
+        queries,
+        {
+          responseType: ShapeDiverSdkApiResponseType.DATA,
+          disableAuthorization: cdnAssetUri.test(url), // disable for CDN URLs
+        },
+      );
       const contentType = header["Content-Type"] ?? header["content-type"];
       return [data, contentType];
     });
@@ -202,7 +221,7 @@ export class ShapeDiverAssetApi extends BaseResourceApi {
       );
 
     return await sendRequest(async () => {
-      const [header, data] = await this.api.get<ArrayBuffer>(url, {
+      const [header, data] = await this.api.get<ArrayBuffer>(url, undefined, {
         responseType: ShapeDiverSdkApiResponseType.DATA,
         disableAuthorization: cdnAssetUri.test(url), // disable for CDN URLs
       });

package/src/resources/ShapeDiverExportApi.ts

@@ -30,6 +30,7 @@ export class ShapeDiverExportApi extends BaseResourceApi {
         (
           await this.api.put<ShapeDiverResponseDto>(
             this.buildSessionUri(sessionId) + "/export",
+            undefined,
             body,
           )
         )[1],
@@ -51,6 +52,7 @@ export class ShapeDiverExportApi extends BaseResourceApi {
         (
           await this.api.put<ShapeDiverResponseDto>(
             this.buildSessionUri(sessionId) + "/export/cache",
+            undefined,
             body,
           )
         )[1],
@@ -72,6 +74,7 @@ export class ShapeDiverExportApi extends BaseResourceApi {
         (
           await this.api.patch<ShapeDiverResponseDto>(
             this.buildModelUri(modelId) + "/export",
+            undefined,
             body,
           )
         )[1],
@@ -92,7 +95,7 @@ export class ShapeDiverExportApi extends BaseResourceApi {
       async () =>
         (
           await this.api.get<ShapeDiverResponseDto>(
-            this.buildSessionUri(sessionId) + "/export/" + exportId + "/list",
+            `${this.buildSessionUri(sessionId)}/export/${exportId}/list`,
           )
         )[1],
     );

package/src/resources/ShapeDiverFileApi.ts

@@ -28,12 +28,18 @@ export class ShapeDiverFileApi extends BaseResourceApi {
   async list(
     sessionId: string,
     paramId: string,
+    offset?: string,
   ): Promise<ShapeDiverResponseDto> {
+    // Build queries
+    const queries: string[] = [];
+    if (offset !== undefined) queries.push("offset=" + offset);
+
     return await sendRequest(
       async () =>
         (
           await this.api.get<ShapeDiverResponseDto>(
             `${this.buildSessionUri(sessionId)}/file/${paramId}/list`,
+            queries,
           )
         )[1],
     );
@@ -91,6 +97,7 @@ export class ShapeDiverFileApi extends BaseResourceApi {
         (
           await this.api.get<ArrayBuffer>(
             `${this.buildSessionUri(sessionId)}/file/${paramId}/${fileId}`,
+            undefined,
             { responseType: ShapeDiverSdkApiResponseType.DATA },
           )
         )[1],
@@ -134,6 +141,7 @@ export class ShapeDiverFileApi extends BaseResourceApi {
         (
           await this.api.post<ShapeDiverResponseDto>(
             this.buildSessionUri(sessionId) + "/file/upload",
+            undefined,
             body,
           )
         )[1],

package/src/resources/ShapeDiverGltfApi.ts

@@ -32,7 +32,8 @@ export class ShapeDiverGltfApi extends BaseResourceApi {
       async () =>
         (
           await this.api.post<ShapeDiverResponseDto>(
-            `${this.buildSessionUri(sessionId)}/gltf?conversion=${queryConvert}`,
+            `${this.buildSessionUri(sessionId)}/gltf`,
+            [`conversion=${queryConvert}`],
             body,
             {
               contentType: type,

package/src/resources/ShapeDiverModelApi.ts

@@ -42,7 +42,13 @@ export class ShapeDiverModelApi extends BaseResourceApi {
   async create(body: ShapeDiverRequestModel): Promise<ShapeDiverResponseDto> {
     return await sendRequest(
       async () =>
-        (await this.api.post<ShapeDiverResponseDto>(this.commonPath, body))[1],
+        (
+          await this.api.post<ShapeDiverResponseDto>(
+            this.commonPath,
+            undefined,
+            body,
+          )
+        )[1],
     );
   }
 
@@ -61,6 +67,7 @@ export class ShapeDiverModelApi extends BaseResourceApi {
         (
           await this.api.put<ShapeDiverResponseDto>(
             this.buildModelUri(modelId),
+            undefined,
             body,
           )
         )[1],
@@ -86,11 +93,18 @@ export class ShapeDiverModelApi extends BaseResourceApi {
   /**
    * List models.
    */
-  async list(): Promise<ShapeDiverResponseDto> {
+  async list(offset?: string): Promise<ShapeDiverResponseDto> {
+    // Build queries
+    const queries: string[] = [];
+    if (offset !== undefined) queries.push("offset=" + offset);
+
     return await sendRequest(
       async () =>
         (
-          await this.api.get<ShapeDiverResponseDto>(`${this.commonPath}/list`)
+          await this.api.get<ShapeDiverResponseDto>(
+            `${this.commonPath}/list`,
+            queries,
+          )
         )[1],
     );
   }
@@ -126,6 +140,7 @@ export class ShapeDiverModelApi extends BaseResourceApi {
         (
           await this.api.post<ShapeDiverResponseDto>(
             this.buildModelUri(modelId) + "/config",
+            undefined,
             body,
           )
         )[1],
@@ -147,6 +162,7 @@ export class ShapeDiverModelApi extends BaseResourceApi {
         (
           await this.api.patch<ShapeDiverResponseDto>(
             this.buildModelUri(modelId) + "/config",
+            undefined,
             body,
           )
         )[1],
@@ -164,6 +180,7 @@ export class ShapeDiverModelApi extends BaseResourceApi {
         (
           await this.api.get<ArrayBuffer>(
             this.buildModelUri(modelId) + "/file/download",
+            undefined,
             {
               contentType: "application/json",
               responseType: ShapeDiverSdkApiResponseType.DATA,
@@ -188,6 +205,7 @@ export class ShapeDiverModelApi extends BaseResourceApi {
         (
           await this.api.patch<ShapeDiverResponseDto>(
             this.buildModelUri(modelId) + "/parameter/defval",
+            undefined,
             body,
           )
         )[1],
@@ -209,6 +227,7 @@ export class ShapeDiverModelApi extends BaseResourceApi {
         (
           await this.api.patch<ShapeDiverResponseDto>(
             this.buildModelUri(modelId) + "/parameter",
+            undefined,
             body,
           )
         )[1],
@@ -255,7 +274,8 @@ export class ShapeDiverModelApi extends BaseResourceApi {
       async () =>
         (
           await this.api.get<ShapeDiverResponseDto>(
-            this.buildModelUri(modelId) + "/computations?" + queries.join("&"),
+            this.buildModelUri(modelId) + "/computations",
+            queries,
           )
         )[1],
     );
@@ -279,9 +299,8 @@ export class ShapeDiverModelApi extends BaseResourceApi {
       async () =>
         (
           await this.api.post<ShapeDiverResponseDto>(
-            this.buildModelUri(modelId) +
-              "/cleanup/export?untilLastSeen=" +
-              untilLastSeen,
+            this.buildModelUri(modelId) + "/cleanup/export",
+            [`untilLastSeen=${untilLastSeen}`],
           )
         )[1],
     );
@@ -305,9 +324,8 @@ export class ShapeDiverModelApi extends BaseResourceApi {
       async () =>
         (
           await this.api.post<ShapeDiverResponseDto>(
-            this.buildModelUri(modelId) +
-              "/cleanup/output?untilLastSeen=" +
-              untilLastSeen,
+            this.buildModelUri(modelId) + "/cleanup/output",
+            [`untilLastSeen=${untilLastSeen}`],
           )
         )[1],
     );
@@ -331,9 +349,8 @@ export class ShapeDiverModelApi extends BaseResourceApi {
       async () =>
         (
           await this.api.post<ShapeDiverResponseDto>(
-            this.buildModelUri(modelId) +
-              "/cleanup/texture?untilLastSeen=" +
-              untilLastSeen,
+            this.buildModelUri(modelId) + "/cleanup/texture",
+            [`untilLastSeen=${untilLastSeen}`],
           )
         )[1],
     );

package/src/resources/ShapeDiverModelStateApi.ts

@@ -0,0 +1,163 @@
+import {
+  BaseResourceApi,
+  ShapeDiverResponseError,
+  ShapeDiverSdkApi,
+  ShapeDiverSdkApiResponseType,
+} from "@shapediver/sdk.geometry-api-sdk-core";
+import { sendRequest } from "../utils/utils";
+import {
+  ShapeDiverRequestModelState,
+  ShapeDiverResponseDto,
+} from "@shapediver/api.geometry-api-dto-v2";
+
+export class ShapeDiverModelStateApi extends BaseResourceApi {
+  constructor(api: ShapeDiverSdkApi) {
+    super(api);
+  }
+
+  /**
+   * Checks the existence of a Model-State.
+   * @param modelStateId The ID of the Model-State.
+   * @returns A boolean indicating whether the Model-State exists.
+   */
+  async exists(modelStateId: string): Promise<boolean> {
+    return await sendRequest(async () => {
+      try {
+        const [_, status] = await this.api.head(
+          this.buildModelStateUri(modelStateId),
+          { disableAuthorization: true },
+        );
+        return status === 200;
+      } catch (e) {
+        // A 404 HTTP status is returned when the Model-State was not found.
+        if (e instanceof ShapeDiverResponseError && e.status === 404)
+          return false;
+        else throw e;
+      }
+    });
+  }
+
+  /**
+   * Get a Model-State.
+   * @param modelStateId The ID of the Model-State.
+   */
+  async get(modelStateId: string): Promise<ShapeDiverResponseDto> {
+    return await sendRequest(
+      async () =>
+        (
+          await this.api.get<ShapeDiverResponseDto>(
+            this.buildModelStateUri(modelStateId),
+          )
+        )[1],
+    );
+  }
+
+  /**
+   * Delete a Model-State.
+   * @param modelStateId The ID of the Model-State.
+   */
+  async delete(modelStateId: string): Promise<void> {
+    return await sendRequest(async () => {
+      await this.api.delete(this.buildModelStateUri(modelStateId));
+    });
+  }
+
+  /**
+   * Get a Model-State's parameter and additional data.
+   * @param modelStateId The ID of the Model-State.
+   */
+  async getData(modelStateId: string): Promise<ShapeDiverResponseDto> {
+    return await sendRequest(
+      async () =>
+        (
+          await this.api.get<ShapeDiverResponseDto>(
+            `${this.buildModelStateUri(modelStateId)}/data`,
+          )
+        )[1],
+    );
+  }
+
+  /**
+   * Check if the Model-State has an image.
+   * @param modelStateId The ID of the Model-State.
+   * @returns A boolean indicating whether the Model-State has an image.
+   */
+  async hasImage(modelStateId: string): Promise<boolean> {
+    return await sendRequest(async () => {
+      try {
+        const [_, status] = await this.api.head(
+          `${this.buildModelStateUri(modelStateId)}/image`,
+          { disableAuthorization: true },
+        );
+        return status === 200;
+      } catch (e) {
+        // A 404 HTTP status is returned when the Model-State image was not found.
+        if (e instanceof ShapeDiverResponseError && e.status === 404)
+          return false;
+        else throw e;
+      }
+    });
+  }
+
+  /**
+   * Downloads the Model-State image.
+   * @param modelStateId The ID of the Model-State.
+   * @returns Array of size 2: [0] = content data, [1] = content type.
+   */
+  async getImage(modelStateId: string): Promise<[ArrayBuffer, string]> {
+    return await sendRequest(async () => {
+      const [header, data] = await this.api.get<ArrayBuffer>(
+        `${this.buildModelStateUri(modelStateId)}/image`,
+        undefined,
+        {
+          responseType: ShapeDiverSdkApiResponseType.DATA,
+          disableAuthorization: true,
+        },
+      );
+      const contentType = header["Content-Type"] ?? header["content-type"];
+      return [data, contentType];
+    });
+  }
+
+  /**
+   * List Model-States of a ShapeDiver model.
+   * @param modelId The ID of the ShapeDiver model.
+   * @param offset The offset to start the list from.
+   */
+  async list(modelId: string, offset?: string): Promise<ShapeDiverResponseDto> {
+    // Build queries
+    const queries: string[] = [];
+    if (offset !== undefined) queries.push("offset=" + offset);
+
+    return await sendRequest(
+      async () =>
+        (
+          await this.api.get<ShapeDiverResponseDto>(
+            `${this.buildModelStateUri()}/model/${modelId}/list`,
+            queries,
+          )
+        )[1],
+    );
+  }
+
+  /**
+   * Create a new Model-State.
+   * @param modelId The ID of the ShapeDiver model.
+   * @param body The Model-State data.
+   */
+  async create(
+    sessionId: string,
+    body: ShapeDiverRequestModelState,
+  ): Promise<ShapeDiverResponseDto> {
+    return await sendRequest(
+      async () =>
+        (
+          await this.api.post<ShapeDiverResponseDto>(
+            `${this.buildSessionUri(sessionId)}/model-state`,
+            undefined,
+            body,
+          )
+        )[1],
+    );
+  }
+}