dalux-build-api 1.1.5 → 2.0.0

package/src/api/CompanyCatalogApi.js

@@ -1,5 +1,9 @@
 'use strict';
 
+const { findByField } = require('../utils/search');
+const { convertToModel } = require('../models/convert');
+const { CompaniesListResponseSchema, CompanyResponseSchema } = require('../models/companies');
+
 /**
  * API methods for the company catalog.
  */
@@ -15,30 +19,33 @@ class CompanyCatalogApi {
    * Get companies registered in the company catalog.
    * GET /2.2/companyCatalog
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} CompaniesListResponse ({ items: ProjectCompany[], metadata?, links? })
    */
-  getCompanies(params = {}) {
-    return this._client.get('/2.2/companyCatalog', params);
+  async getCompanies(params = {}) {
+    const response = await this._client.get('/2.2/companyCatalog', params);
+    return convertToModel(response, CompaniesListResponseSchema, 'CompaniesListResponse');
   }
 
   /**
    * Get a specific company from the catalog.
    * GET /1.2/companyCatalog/{catalogCompanyId}
    * @param {string} catalogCompanyId
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} CompanyResponse ({ data: ProjectCompany, links? })
    */
-  getCompany(catalogCompanyId) {
-    return this._client.get(`/1.2/companyCatalog/${catalogCompanyId}`);
+  async getCompany(catalogCompanyId) {
+    const response = await this._client.get(`/1.2/companyCatalog/${catalogCompanyId}`);
+    return convertToModel(response, CompanyResponseSchema, 'CompanyResponse');
   }
 
   /**
    * Add a company to the catalog.
    * POST /2.2/companyCatalog
    * @param {object} body
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} CompanyResponse
    */
-  createCompany(body) {
-    return this._client.post('/2.2/companyCatalog', body);
+  async createCompany(body) {
+    const response = await this._client.post('/2.2/companyCatalog', body);
+    return convertToModel(response, CompanyResponseSchema, 'CompanyResponse');
   }
 
   /**
@@ -46,10 +53,11 @@ class CompanyCatalogApi {
    * PATCH /2.1/companyCatalog/{catalogCompanyId}
    * @param {string} catalogCompanyId
    * @param {object} body
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} CompanyResponse
    */
-  updateCompany(catalogCompanyId, body) {
-    return this._client.patch(`/2.1/companyCatalog/${catalogCompanyId}`, body);
+  async updateCompany(catalogCompanyId, body) {
+    const response = await this._client.patch(`/2.1/companyCatalog/${catalogCompanyId}`, body);
+    return convertToModel(response, CompanyResponseSchema, 'CompanyResponse');
   }
 
   /**
@@ -110,15 +118,11 @@ class CompanyCatalogApi {
    * @returns {Promise<string|null>} The catalogCompanyId, or null if not found.
    */
   async getCompanyByName(companyName) {
-    const { findByField } = require('../utils/search');
     const response = await this.getCompanies();
     const items = (response && response.items) || [];
-    const company =
-      findByField(items, 'companyName', companyName, (x) => x.data || x) ||
-      findByField(items, 'name', companyName, (x) => x.data || x);
+    const company = findByField(items, 'name', companyName);
     if (!company) return null;
-    const data = company.data || company;
-    return data.catalogCompanyId || data.id || null;
+    return company.catalogCompanyId || null;
   }
 }
 

package/src/api/FileAreasApi.js

@@ -1,5 +1,9 @@
 'use strict';
 
+const { findByField } = require('../utils/search');
+const { convertToModel } = require('../models/convert');
+const { FileAreaSchema, FileAreasListResponseSchema } = require('../models/fileAreas');
+
 /**
  * API methods for file areas on a project.
  */
@@ -16,10 +20,11 @@ class FileAreasApi {
    * GET /5.1/projects/{projectId}/file_areas
    * @param {string} projectId
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} FileAreasListResponse ({ items: FileArea[], metadata?, links? })
    */
-  getFileAreas(projectId, params = {}) {
-    return this._client.get(`/5.1/projects/${projectId}/file_areas`, params);
+  async getFileAreas(projectId, params = {}) {
+    const response = await this._client.get(`/5.1/projects/${projectId}/file_areas`, params);
+    return convertToModel(response, FileAreasListResponseSchema, 'FileAreasListResponse');
   }
 
   /**
@@ -27,10 +32,11 @@ class FileAreasApi {
    * GET /1.0/projects/{projectId}/file_areas/{fileAreaId}
    * @param {string} projectId
    * @param {string} fileAreaId
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} FileArea (not wrapped in a data envelope, matches Python)
    */
-  getFileArea(projectId, fileAreaId) {
-    return this._client.get(`/1.0/projects/${projectId}/file_areas/${fileAreaId}`);
+  async getFileArea(projectId, fileAreaId) {
+    const response = await this._client.get(`/1.0/projects/${projectId}/file_areas/${fileAreaId}`);
+    return convertToModel(response, FileAreaSchema, 'FileArea');
   }
 
   /**
@@ -40,15 +46,11 @@ class FileAreasApi {
    * @returns {Promise<string|null>} The fileAreaId, or null if not found.
    */
   async getFileAreaByName(projectId, fileAreaName) {
-    const { findByField } = require('../utils/search');
     const response = await this.getFileAreas(projectId);
     const items = (response && response.items) || [];
-    const area =
-      findByField(items, 'fileAreaName', fileAreaName, (x) => x.data || x) ||
-      findByField(items, 'name', fileAreaName, (x) => x.data || x);
+    const area = findByField(items, 'fileAreaName', fileAreaName);
     if (!area) return null;
-    const data = area.data || area;
-    return data.fileAreaId || data.id || null;
+    return area.fileAreaId || null;
   }
 }
 

package/src/api/FilesApi.js

@@ -7,6 +7,8 @@ const axios = require('axios');
 const { findByField, findAllByField } = require('../utils/search');
 const { resolveFolderIdFromNamedPath } = require('../utils/pathResolver');
 const { validateProjectId, validateFileAreaId, validateFolderId } = require('../utils/validation');
+const { convertToModel, convertToModelList } = require('../models/convert');
+const { FileSchema, FileResponseSchema, FilesListResponseSchema } = require('../models/files');
 
 /**
  * API methods for files within a file area.
@@ -27,11 +29,12 @@ class FilesApi {
    * @param {object} [params] - Optional params (e.g. folderId, updatedAfter, includeProperties). The files endpoint does not support OData $filter.
    * @returns {Promise<object>}
    */
-  listFiles(projectId, fileAreaId, params = {}) {
-    return this._client.get(
+  async listFiles(projectId, fileAreaId, params = {}) {
+    const response = await this._client.get(
       `/6.1/projects/${projectId}/file_areas/${fileAreaId}/files`,
       params,
     );
+    return convertToModel(response, FilesListResponseSchema, 'FilesListResponse');
   }
 
   /**
@@ -75,7 +78,7 @@ class FilesApi {
     if (verbose) {
       console.log(`Done. Total files retrieved: ${allItems.length}`);
     }
-    return allItems;
+    return convertToModelList(allItems, FileSchema, 'File');
   }
 
   /**
@@ -208,9 +211,10 @@ class FilesApi {
     }
 
     // ID-based lookup (original behaviour)
-    const fileInfo = await this._client.get(
+    const rawResponse = await this._client.get(
       `/5.0/projects/${projectId}/file_areas/${fileAreaIdOrPath}/files/${fileId}`,
     );
+    const fileInfo = convertToModel(rawResponse, FileResponseSchema, 'FileResponse');
     if (options.download && fileInfo && fileInfo.data && fileInfo.data.downloadLink) {
       const name = fileInfo.data.fileName || fileId;
       const downloadedPath = await this.downloadFileFromLink(
@@ -538,11 +542,11 @@ class FilesApi {
     const question = (prompt) => new Promise((resolve) => rl.question(prompt, resolve));
 
     function getFid(f) {
-      const d = f.data || {};
+      const d = f.data || f || {};
       return d.id || d.fileId || null;
     }
     function getFname(f) {
-      return (f.data || {}).fileName || '<unknown>';
+      return (f.data || f || {}).fileName || '<unknown>';
     }
     function hasContent(node) {
       if (node.files.length) return true;

package/src/api/FoldersApi.js

@@ -4,6 +4,8 @@ const { paginate } = require('../utils/pagination');
 const { findByField } = require('../utils/search');
 const { validateProjectId, validateFileAreaId } = require('../utils/validation');
 const { resolveFolderIdFromNamedPath } = require('../utils/pathResolver');
+const { convertToModel, convertToModelList } = require('../models/convert');
+const { FolderSchema, FolderResponseSchema, FoldersListResponseSchema } = require('../models/folders');
 
 /**
  * API methods for folders within a file area.
@@ -24,11 +26,12 @@ class FoldersApi {
    * @param {object} [params]
    * @returns {Promise<object>}
    */
-  listFolders(projectId, fileAreaId, params = {}) {
-    return this._client.get(
+  async listFolders(projectId, fileAreaId, params = {}) {
+    const response = await this._client.get(
       `/5.1/projects/${projectId}/file_areas/${fileAreaId}/folders`,
       params,
     );
+    return convertToModel(response, FoldersListResponseSchema, 'FoldersListResponse');
   }
 
   /**
@@ -43,7 +46,8 @@ class FoldersApi {
     validateProjectId(projectId);
     validateFileAreaId(fileAreaId);
     const endpoint = `/5.1/projects/${projectId}/file_areas/${fileAreaId}/folders`;
-    return paginate(endpoint, this._client, params, verbose);
+    const raw = await paginate(endpoint, this._client, params, verbose);
+    return convertToModelList(raw, FolderSchema, 'Folder');
   }
 
   /**
@@ -54,10 +58,11 @@ class FoldersApi {
    * @param {string} folderId
    * @returns {Promise<object>}
    */
-  getFolder(projectId, fileAreaId, folderId) {
-    return this._client.get(
+  async getFolder(projectId, fileAreaId, folderId) {
+    const response = await this._client.get(
       `/5.0/projects/${projectId}/file_areas/${fileAreaId}/folders/${folderId}`,
     );
+    return convertToModel(response, FolderResponseSchema, 'FolderResponse');
   }
 
   /**
@@ -103,15 +108,12 @@ class FoldersApi {
     validateProjectId(projectId);
     validateFileAreaId(fileAreaId);
     const allFolders = await this.getAllFolders(projectId, fileAreaId);
-    const folder = findByField(allFolders, 'folderName', folderName, (x) => x.data || x)
-      || findByField(allFolders, 'name', folderName, (x) => x.data || x);
+    const folder = findByField(allFolders, 'folderName', folderName);
     if (!folder) return null;
-    if (parentFolderId != null) {
-      const data = folder.data || folder;
-      const pid = data.parentFolderId || data.parentId;
-      if (pid !== parentFolderId) return null;
+    if (parentFolderId != null && folder.parentFolderId !== parentFolderId) {
+      return null;
     }
-    return folder;
+    return convertToModel({ data: folder }, FolderResponseSchema, 'FolderResponse');
   }
 
   /**

package/src/api/FormsApi.js

@@ -1,5 +1,8 @@
 'use strict';
 
+const { convertToModel } = require('../models/convert');
+const { FormsListResponseSchema, FormResponseSchema } = require('../models/forms');
+
 /**
  * API methods for forms on a project.
  */
@@ -16,10 +19,11 @@ class FormsApi {
    * GET /2.1/projects/{projectId}/forms
    * @param {string} projectId
    * @param {object} [params] - Optional filters (e.g. updatedAfter)
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} FormsListResponse ({ items, metadata?, links? })
    */
-  getProjectForms(projectId, params = {}) {
-    return this._client.get(`/2.1/projects/${projectId}/forms`, params);
+  async getProjectForms(projectId, params = {}) {
+    const response = await this._client.get(`/2.1/projects/${projectId}/forms`, params);
+    return convertToModel(response, FormsListResponseSchema, 'FormsListResponse');
   }
 
   /**
@@ -27,10 +31,11 @@ class FormsApi {
    * GET /1.2/projects/{projectId}/forms/{formId}
    * @param {string} projectId
    * @param {string} formId
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} FormResponse ({ data, links? })
    */
-  getForm(projectId, formId) {
-    return this._client.get(`/1.2/projects/${projectId}/forms/${formId}`);
+  async getForm(projectId, formId) {
+    const response = await this._client.get(`/1.2/projects/${projectId}/forms/${formId}`);
+    return convertToModel(response, FormResponseSchema, 'FormResponse');
   }
 
   /**

package/src/api/InspectionPlansApi.js

@@ -1,5 +1,8 @@
 'use strict';
 
+const { convertToModel } = require('../models/convert');
+const { InspectionPlansListResponseSchema } = require('../models/inspectionPlans');
+
 /**
  * API methods for inspection plans.
  */
@@ -16,10 +19,11 @@ class InspectionPlansApi {
    * GET /1.2/projects/{projectId}/inspectionPlans
    * @param {string} projectId
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} InspectionPlansListResponse ({ items, metadata?, links? })
    */
-  listInspectionPlans(projectId, params = {}) {
-    return this._client.get(`/1.2/projects/${projectId}/inspectionPlans`, params);
+  async listInspectionPlans(projectId, params = {}) {
+    const response = await this._client.get(`/1.2/projects/${projectId}/inspectionPlans`, params);
+    return convertToModel(response, InspectionPlansListResponseSchema, 'InspectionPlansListResponse');
   }
 
   /**

package/src/api/ProjectsApi.js

@@ -1,5 +1,9 @@
 'use strict';
 
+const { findByField } = require('../utils/search');
+const { convertToModel } = require('../models/convert');
+const { ProjectsListResponseSchema, ProjectResponseSchema } = require('../models/projects');
+
 /**
  * API methods for project management.
  */
@@ -15,30 +19,33 @@ class ProjectsApi {
    * Get all available projects.
    * GET /5.1/projects
    * @param {object} [params] - Optional query parameters (e.g. updatedAfter)
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} ProjectsListResponse ({ items: Project[], metadata?, links? })
    */
-  listProjects(params = {}) {
-    return this._client.get('/5.1/projects', params);
+  async listProjects(params = {}) {
+    const response = await this._client.get('/5.1/projects', params);
+    return convertToModel(response, ProjectsListResponseSchema, 'ProjectsListResponse');
   }
 
   /**
    * Get a specific project.
    * GET /5.0/projects/{projectId}
    * @param {string} projectId
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} ProjectResponse ({ data: Project, links? })
    */
-  getProject(projectId) {
-    return this._client.get(`/5.0/projects/${projectId}`);
+  async getProject(projectId) {
+    const response = await this._client.get(`/5.0/projects/${projectId}`);
+    return convertToModel(response, ProjectResponseSchema, 'ProjectResponse');
   }
 
   /**
    * Create a new project.
    * POST /5.0/projects
    * @param {object} body
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} ProjectResponse
    */
-  createProject(body) {
-    return this._client.post('/5.0/projects', body);
+  async createProject(body) {
+    const response = await this._client.post('/5.0/projects', body);
+    return convertToModel(response, ProjectResponseSchema, 'ProjectResponse');
   }
 
   /**
@@ -46,10 +53,11 @@ class ProjectsApi {
    * PATCH /5.0/projects/{projectId}
    * @param {string} projectId
    * @param {object} body
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} ProjectResponse
    */
-  updateProject(projectId, body) {
-    return this._client.patch(`/5.0/projects/${projectId}`, body);
+  async updateProject(projectId, body) {
+    const response = await this._client.patch(`/5.0/projects/${projectId}`, body);
+    return convertToModel(response, ProjectResponseSchema, 'ProjectResponse');
   }
 
   /**
@@ -108,15 +116,11 @@ class ProjectsApi {
    * @returns {Promise<string|null>} The projectId, or null if not found.
    */
   async getProjectByName(projectName) {
-    const { findByField } = require('../utils/search');
     const response = await this.listProjects();
     const items = (response && response.items) || [];
-    const project =
-      findByField(items, 'projectName', projectName, (x) => x.data || x) ||
-      findByField(items, 'name', projectName, (x) => x.data || x);
+    const project = findByField(items, 'projectName', projectName);
     if (!project) return null;
-    const data = project.data || project;
-    return data.projectId || data.id || null;
+    return project.projectId || null;
   }
 }
 

package/src/api/TasksApi.js

@@ -1,5 +1,15 @@
 'use strict';
 
+const { convertToModel, convertToModelList } = require('../models/convert');
+const {
+  TaskSchema,
+  TaskChangeSchema,
+  TasksListResponseSchema,
+  TaskResponseSchema,
+  TaskChangesSchema,
+  TaskAttachmentsListResponseSchema,
+} = require('../models/tasks');
+
 /**
  * Build query params for GET /5.2/projects/.../tasks (OData).
  * If params contains typeId and no $filter, expands to
@@ -39,8 +49,9 @@ class TasksApi {
    *   OData $filter on task type, or pass $filter (and other OData options) directly.
    * @returns {Promise<object>}
    */
-  getProjectTasks(projectId, params = {}) {
-    return this._client.get(`/5.2/projects/${projectId}/tasks`, normalizeTaskParams(params));
+  async getProjectTasks(projectId, params = {}) {
+    const response = await this._client.get(`/5.2/projects/${projectId}/tasks`, normalizeTaskParams(params));
+    return convertToModel(response, TasksListResponseSchema, 'TasksListResponse');
   }
 
   /**
@@ -119,7 +130,7 @@ class TasksApi {
     if (verbose) {
       console.log(`Done. Total tasks retrieved: ${allItems.length}`);
     }
-    return allItems;
+    return convertToModelList(allItems, TaskSchema, 'Task');
   }
 
   /**
@@ -129,8 +140,9 @@ class TasksApi {
    * @param {string} taskId
    * @returns {Promise<object>}
    */
-  getTask(projectId, taskId) {
-    return this._client.get(`/3.3/projects/${projectId}/tasks/${taskId}`);
+  async getTask(projectId, taskId) {
+    const response = await this._client.get(`/3.3/projects/${projectId}/tasks/${taskId}`);
+    return convertToModel(response, TaskResponseSchema, 'TaskResponse');
   }
 
   /**
@@ -140,8 +152,9 @@ class TasksApi {
    * @param {object} [params] - Optional filters (e.g. updatedAfter)
    * @returns {Promise<object>}
    */
-  getProjectTaskChanges(projectId, params = {}) {
-    return this._client.get(`/2.2/projects/${projectId}/tasks/changes`, params);
+  async getProjectTaskChanges(projectId, params = {}) {
+    const response = await this._client.get(`/2.2/projects/${projectId}/tasks/changes`, params);
+    return convertToModel(response, TaskChangesSchema, 'TaskChanges');
   }
 
   /**
@@ -151,8 +164,9 @@ class TasksApi {
    * @param {object} [params] - Optional filters (e.g. updatedAfter)
    * @returns {Promise<object>}
    */
-  getProjectTaskAttachments(projectId, params = {}) {
-    return this._client.get(`/1.1/projects/${projectId}/tasks/attachments`, params);
+  async getProjectTaskAttachments(projectId, params = {}) {
+    const response = await this._client.get(`/1.1/projects/${projectId}/tasks/attachments`, params);
+    return convertToModel(response, TaskAttachmentsListResponseSchema, 'TaskAttachmentsListResponse');
   }
 
   /**
@@ -164,12 +178,13 @@ class TasksApi {
    */
   async getAllProjectTaskChanges(projectId, params = {}, verbose = false) {
     const { paginate } = require('../utils/pagination');
-    return paginate(
+    const raw = await paginate(
       `/2.2/projects/${projectId}/tasks/changes`,
       this._client,
       params,
       verbose,
     );
+    return convertToModelList(raw, TaskChangeSchema, 'TaskChange');
   }
 }
 

package/src/api/TestPlansApi.js

@@ -1,5 +1,8 @@
 'use strict';
 
+const { convertToModel } = require('../models/convert');
+const { TestPlansListResponseSchema } = require('../models/testPlans');
+
 /**
  * API methods for test plans.
  */
@@ -16,10 +19,11 @@ class TestPlansApi {
    * GET /1.2/projects/{projectId}/testPlans
    * @param {string} projectId
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} TestPlansListResponse ({ items, metadata?, links? })
    */
-  listTestPlans(projectId, params = {}) {
-    return this._client.get(`/1.2/projects/${projectId}/testPlans`, params);
+  async listTestPlans(projectId, params = {}) {
+    const response = await this._client.get(`/1.2/projects/${projectId}/testPlans`, params);
+    return convertToModel(response, TestPlansListResponseSchema, 'TestPlansListResponse');
   }
 
   /**

package/src/api/UsersApi.js

@@ -1,5 +1,8 @@
 'use strict';
 
+const { convertToModel } = require('../models/convert');
+const { UserResponseSchema, UsersListResponseSchema } = require('../models/users');
+
 /**
  * API methods for users.
  */
@@ -15,10 +18,11 @@ class UsersApi {
    * Get a specific user.
    * GET /1.1/users/{userId}
    * @param {string} userId
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} UserResponse ({ data: User, links? })
    */
-  getUser(userId) {
-    return this._client.get(`/1.1/users/${userId}`);
+  async getUser(userId) {
+    const response = await this._client.get(`/1.1/users/${userId}`);
+    return convertToModel(response, UserResponseSchema, 'UserResponse');
   }
 
   /**
@@ -26,10 +30,11 @@ class UsersApi {
    * GET /1.2/projects/{projectId}/users
    * @param {string} projectId
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} UsersListResponse ({ items: ProjectUser[], metadata?, links? })
    */
-  listProjectUsers(projectId, params = {}) {
-    return this._client.get(`/1.2/projects/${projectId}/users`, params);
+  async listProjectUsers(projectId, params = {}) {
+    const response = await this._client.get(`/1.2/projects/${projectId}/users`, params);
+    return convertToModel(response, UsersListResponseSchema, 'UsersListResponse');
   }
 
   /**

package/src/api/VersionSetsApi.js

@@ -1,5 +1,9 @@
 'use strict';
 
+const { convertToModel } = require('../models/convert');
+const { VersionSetsListResponseSchema, VersionSetResponseSchema } = require('../models/versionSets');
+const { FilesListResponseSchema } = require('../models/files');
+
 /**
  * API methods for version sets.
  */
@@ -16,10 +20,11 @@ class VersionSetsApi {
    * GET /2.1/projects/{projectId}/version_sets
    * @param {string} projectId
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} VersionSetsListResponse ({ items: VersionSet[], metadata?, links? })
    */
-  getVersionSets(projectId, params = {}) {
-    return this._client.get(`/2.1/projects/${projectId}/version_sets`, params);
+  async getVersionSets(projectId, params = {}) {
+    const response = await this._client.get(`/2.1/projects/${projectId}/version_sets`, params);
+    return convertToModel(response, VersionSetsListResponseSchema, 'VersionSetsListResponse');
   }
 
   /**
@@ -27,10 +32,11 @@ class VersionSetsApi {
    * GET /2.0/projects/{projectId}/version_sets/{versionSetId}
    * @param {string} projectId
    * @param {string} versionSetId
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} VersionSetResponse ({ data: VersionSet, links? })
    */
-  getVersionSet(projectId, versionSetId) {
-    return this._client.get(`/2.0/projects/${projectId}/version_sets/${versionSetId}`);
+  async getVersionSet(projectId, versionSetId) {
+    const response = await this._client.get(`/2.0/projects/${projectId}/version_sets/${versionSetId}`);
+    return convertToModel(response, VersionSetResponseSchema, 'VersionSetResponse');
   }
 
   /**
@@ -39,13 +45,14 @@ class VersionSetsApi {
    * @param {string} projectId
    * @param {string} fileAreaId
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} VersionSetsListResponse
    */
-  listFileAreaVersionSets(projectId, fileAreaId, params = {}) {
-    return this._client.get(
+  async listFileAreaVersionSets(projectId, fileAreaId, params = {}) {
+    const response = await this._client.get(
       `/2.1/projects/${projectId}/file_areas/${fileAreaId}/version_sets`,
       params,
     );
+    return convertToModel(response, VersionSetsListResponseSchema, 'VersionSetsListResponse');
   }
 
   /**
@@ -54,13 +61,14 @@ class VersionSetsApi {
    * @param {string} projectId
    * @param {string} versionSetId
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} FilesListResponse (cross-endpoint reuse of the Files model, matches Python)
    */
-  listVersionSetFiles(projectId, versionSetId, params = {}) {
-    return this._client.get(
+  async listVersionSetFiles(projectId, versionSetId, params = {}) {
+    const response = await this._client.get(
       `/3.0/projects/${projectId}/version_sets/${versionSetId}/files`,
       params,
     );
+    return convertToModel(response, FilesListResponseSchema, 'FilesListResponse');
   }
 }
 

package/src/api/WorkPackagesApi.js

@@ -1,5 +1,8 @@
 'use strict';
 
+const { convertToModel } = require('../models/convert');
+const { WorkPackagesListResponseSchema } = require('../models/workPackages');
+
 /**
  * API methods for work packages on a project.
  */
@@ -16,10 +19,11 @@ class WorkPackagesApi {
    * GET /1.0/projects/{projectId}/workpackages
    * @param {string} projectId
    * @param {object} [params]
-   * @returns {Promise<object>}
+   * @returns {Promise<object>} WorkPackagesListResponse ({ items: WorkPackage[], metadata?, links? })
    */
-  listWorkPackages(projectId, params = {}) {
-    return this._client.get(`/1.0/projects/${projectId}/workpackages`, params);
+  async listWorkPackages(projectId, params = {}) {
+    const response = await this._client.get(`/1.0/projects/${projectId}/workpackages`, params);
+    return convertToModel(response, WorkPackagesListResponseSchema, 'WorkPackagesListResponse');
   }
 }