dalux-build-api 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bruno Adam
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,300 @@
+# Dalux Build API
+
+API clients for the [Dalux Build REST API](https://app.swaggerhub.com/apis-docs/Dalux/DaluxBuild-api/4.14), available in two languages:
+
+| Language | Location | Documentation |
+|---|---|---|
+| Node.js | [`/`](.) | See below |
+| Python | [`/python`](python/) | [python/README.md](python/README.md) |
+
+---
+
+# Node.js Client
+
+A lightweight Node.js client for the Dalux Build REST API.
+
+## Requirements
+
+- Node.js 14 or later
+
+## Installation
+
+```bash
+npm install dalux-build-api
+```
+
+## Getting Started
+
+To access the API you need:
+
+1. A company-specific **base URL** (obtain from Dalux support at <support@dalux.com>).
+2. An **API key** — managed via _Settings › Integrations › API Identities_ inside the Dalux Build UI.
+
+```js
+const { createClient } = require('dalux-build-api');
+
+const dalux = createClient({
+  baseUrl: 'https://<your-company>.dalux.com/api',
+  apiKey:  'YOUR_API_KEY',
+});
+```
+
+The returned object exposes one namespace per API group (see [API Reference](#api-reference) below).
+
+### Examples
+
+**List all projects**
+```js
+const projects = await dalux.projects.listProjects();
+console.log(projects);
+```
+
+**Get a specific project**
+```js
+const project = await dalux.projects.getProject('my-project-id');
+console.log(project);
+```
+
+**List tasks on a project**
+```js
+const tasks = await dalux.tasks.getProjectTasks('my-project-id', {
+  updatedAfter: '2024-01-01',
+});
+console.log(tasks);
+```
+
+**Upload a file (chunked)**
+```js
+const fs = require('fs');
+
+// 1. Create an upload slot
+const { uploadGuid } = await dalux.fileUpload.createUpload(
+  'my-project-id',
+  'my-file-area-id',
+  { fileName: 'drawing.pdf', mimeType: 'application/pdf' },
+);
+
+// 2. Upload the file in one chunk
+const content = fs.readFileSync('./drawing.pdf');
+await dalux.fileUpload.uploadFilePart('my-project-id', 'my-file-area-id', uploadGuid, content);
+
+// 3. Finalize the upload
+const result = await dalux.fileUpload.finishUpload(
+  'my-project-id',
+  'my-file-area-id',
+  uploadGuid,
+  { folderId: 'target-folder-id' },
+);
+console.log('New file ID:', result.fileId);
+```
+
+## Authentication
+
+Every request automatically includes the `X-API-KEY` header with the API key supplied to `createClient`. No additional configuration is required.
+
+## Error Handling
+
+All methods return Promises. Network or HTTP errors (4xx / 5xx) are thrown as Axios errors, so wrap calls with `try/catch` or `.catch()`:
+
+```js
+try {
+  const project = await dalux.projects.getProject('unknown-id');
+} catch (err) {
+  console.error(err.response?.status, err.response?.data);
+}
+```
+
+## API Reference
+
+All API namespaces are accessible on the object returned by `createClient`:
+
+| Namespace | Class | Description |
+|---|---|---|
+| `projects` | `ProjectsApi` | List, get, create and update projects; manage project metadata |
+| `companies` | `CompaniesApi` | Project companies (CRUD) |
+| `companyCatalog` | `CompanyCatalogApi` | Company catalog (CRUD + metadata) |
+| `tasks` | `TasksApi` | Tasks, approvals, safety issues, observations & good practices |
+| `fileAreas` | `FileAreasApi` | File areas on a project |
+| `files` | `FilesApi` | Files within a file area |
+| `folders` | `FoldersApi` | Folders within a file area |
+| `fileUpload` | `FileUploadApi` | Chunked file upload (create slot → upload parts → finalize) |
+| `fileRevisions` | `FileRevisionsApi` | Download file revision content |
+| `forms` | `FormsApi` | Forms and form attachments |
+| `users` | `UsersApi` | Company and project users |
+| `projectTemplates` | `ProjectTemplatesApi` | Available project templates |
+| `inspectionPlans` | `InspectionPlansApi` | Inspection plans, items, zones and registrations |
+| `testPlans` | `TestPlansApi` | Test plans, items, zones and registrations |
+| `versionSets` | `VersionSetsApi` | Version sets and version set files |
+| `workPackages` | `WorkPackagesApi` | Work packages on a project |
+
+### ProjectsApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `listProjects(params?)` | GET | `/5.1/projects` |
+| `getProject(projectId)` | GET | `/5.0/projects/{projectId}` |
+| `createProject(body)` | POST | `/5.0/projects` |
+| `updateProject(projectId, body)` | PATCH | `/5.0/projects/{projectId}` |
+| `listMetadataMappingsForProjects()` | GET | `/1.0/projects/metadata/1.0/mappings` |
+| `listMetadataValuesForProjects(key)` | GET | `/1.0/projects/metadata/1.0/mappings/{key}/values` |
+| `listProjectMetadata(projectId)` | GET | `/1.0/projects/{projectId}/metadata` |
+| `listProjectMetadataMappings(projectId)` | GET | `/1.0/projects/{projectId}/metadata/1.0/mappings` |
+| `listProjectMetadataValues(projectId, key)` | GET | `/1.0/projects/{projectId}/metadata/1.0/mappings/{key}/values` |
+
+### CompaniesApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `listProjectCompanies(projectId, params?)` | GET | `/3.1/projects/{projectId}/companies` |
+| `getProjectCompany(projectId, companyId)` | GET | `/3.0/projects/{projectId}/companies/{companyId}` |
+| `createProjectCompany(projectId, body)` | POST | `/3.1/projects/{projectId}/companies` |
+| `updateProjectCompany(projectId, companyId, body)` | PATCH | `/3.0/projects/{projectId}/companies/{companyId}` |
+
+### CompanyCatalogApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `getCompanies(params?)` | GET | `/2.2/companyCatalog` |
+| `getCompany(catalogCompanyId)` | GET | `/1.2/companyCatalog/{catalogCompanyId}` |
+| `createCompany(body)` | POST | `/2.2/companyCatalog` |
+| `updateCompany(catalogCompanyId, body)` | PATCH | `/2.1/companyCatalog/{catalogCompanyId}` |
+| `listCompanyMetadata(catalogCompanyId)` | GET | `/1.0/companyCatalog/{catalogCompanyId}/metadata` |
+| `listCompanyMetadataMappings(catalogCompanyId)` | GET | `/1.0/companyCatalog/{catalogCompanyId}/metadata/1.0/mappings` |
+| `listCompanyMetadataValues(catalogCompanyId, key)` | GET | `/1.0/companyCatalog/{catalogCompanyId}/metadata/1.0/mappings/{key}/values` |
+| `listMetadataMappingsForCompanies()` | GET | `/1.0/companyCatalog/metadata/1.0/mappings` |
+| `listMetadataValuesForCompanies(key)` | GET | `/1.0/companyCatalog/metadata/1.0/mappings/{key}/values` |
+
+### TasksApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `getProjectTasks(projectId, params?)` | GET | `/5.1/projects/{projectId}/tasks` |
+| `getTask(projectId, taskId)` | GET | `/3.3/projects/{projectId}/tasks/{taskId}` |
+| `getProjectTaskChanges(projectId, params?)` | GET | `/2.2/projects/{projectId}/tasks/changes` |
+| `getProjectTaskAttachments(projectId, params?)` | GET | `/1.1/projects/{projectId}/tasks/attachments` |
+
+### FileAreasApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `getFileAreas(projectId, params?)` | GET | `/5.1/projects/{projectId}/file_areas` |
+| `getFileArea(projectId, fileAreaId)` | GET | `/1.0/projects/{projectId}/file_areas/{fileAreaId}` |
+
+### FilesApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `listFiles(projectId, fileAreaId, params?)` | GET | `/6.0/projects/{projectId}/file_areas/{fileAreaId}/files` |
+| `getFile(projectId, fileAreaId, fileId)` | GET | `/5.0/projects/{projectId}/file_areas/{fileAreaId}/files/{fileId}` |
+| `getFilePropertiesMapping(projectId, fileAreaId, fileId)` | GET | `/1.0/.../files/{fileId}/properties/1.0/mappings` |
+| `getFilePropertyMappingValues(projectId, fileAreaId, filePropertyId)` | GET | `/1.0/.../files/properties/1.0/mappings/{filePropertyId}/values` |
+
+### FoldersApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `listFolders(projectId, fileAreaId, params?)` | GET | `/5.1/projects/{projectId}/file_areas/{fileAreaId}/folders` |
+| `getFolder(projectId, fileAreaId, folderId)` | GET | `/5.0/projects/{projectId}/file_areas/{fileAreaId}/folders/{folderId}` |
+| `getFolderFilesProperties(projectId, fileAreaId, folderId)` | GET | `/1.0/.../folders/{folderId}/files/properties/1.0/mappings` |
+
+### FileUploadApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `createUpload(projectId, fileAreaId, body)` | POST | `/1.0/projects/{projectId}/file_areas/{fileAreaId}/upload` |
+| `uploadFilePart(projectId, fileAreaId, uploadGuid, chunk)` | POST | `/1.0/.../upload/{uploadGuid}` |
+| `finishUpload(projectId, fileAreaId, uploadGuid, body)` | POST | `/2.0/.../upload/{uploadGuid}/finalize` |
+
+### FileRevisionsApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `getFileRevisionContent(projectId, fileAreaId, fileId, fileRevisionId)` | GET | `/2.0/.../files/{fileId}/revisions/{fileRevisionId}/content` |
+
+### FormsApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `getProjectForms(projectId, params?)` | GET | `/2.1/projects/{projectId}/forms` |
+| `getForm(projectId, formId)` | GET | `/1.2/projects/{projectId}/forms/{formId}` |
+| `getProjectFormAttachments(projectId, params?)` | GET | `/2.1/projects/{projectId}/forms/attachments` |
+
+### UsersApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `getUser(userId)` | GET | `/1.1/users/{userId}` |
+| `listProjectUsers(projectId, params?)` | GET | `/1.2/projects/{projectId}/users` |
+| `getProjectUser(projectId, userId)` | GET | `/1.1/projects/{projectId}/users/{userId}` |
+
+### ProjectTemplatesApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `listProjectTemplates(params?)` | GET | `/1.1/projectTemplates` |
+
+### InspectionPlansApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `listInspectionPlans(projectId, params?)` | GET | `/1.2/projects/{projectId}/inspectionPlans` |
+| `listInspectionPlanItems(projectId, params?)` | GET | `/1.1/projects/{projectId}/inspectionPlanItems` |
+| `listInspectionPlanItemZones(projectId, params?)` | GET | `/1.1/projects/{projectId}/inspectionPlanItemZones` |
+| `listInspectionPlanRegistrations(projectId, params?)` | GET | `/2.1/projects/{projectId}/inspectionPlanRegistrations` |
+
+### TestPlansApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `listTestPlans(projectId, params?)` | GET | `/1.2/projects/{projectId}/testPlans` |
+| `listTestPlanItems(projectId, params?)` | GET | `/1.1/projects/{projectId}/testPlanItems` |
+| `listTestPlanItemZones(projectId, params?)` | GET | `/1.1/projects/{projectId}/testPlanItemZones` |
+| `listTestPlanRegistrations(projectId, params?)` | GET | `/1.1/projects/{projectId}/testPlanRegistrations` |
+
+### VersionSetsApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `getVersionSets(projectId, params?)` | GET | `/2.1/projects/{projectId}/version_sets` |
+| `getVersionSet(projectId, versionSetId)` | GET | `/2.0/projects/{projectId}/version_sets/{versionSetId}` |
+| `listFileAreaVersionSets(projectId, fileAreaId, params?)` | GET | `/2.1/projects/{projectId}/file_areas/{fileAreaId}/version_sets` |
+| `listVersionSetFiles(projectId, versionSetId, params?)` | GET | `/3.0/projects/{projectId}/version_sets/{versionSetId}/files` |
+
+### WorkPackagesApi
+
+| Method | HTTP | Path |
+|---|---|---|
+| `listWorkPackages(projectId, params?)` | GET | `/1.0/projects/{projectId}/workpackages` |
+
+## Advanced Usage
+
+### Using individual API classes
+
+You can also instantiate API classes directly with a shared `ApiClient`:
+
+```js
+const { Configuration, ApiClient, ProjectsApi, TasksApi } = require('dalux-build-api');
+
+const config = new Configuration({
+  baseUrl: 'https://<your-company>.dalux.com/api',
+  apiKey:  'YOUR_API_KEY',
+});
+const apiClient = new ApiClient(config);
+
+const projects = new ProjectsApi(apiClient);
+const tasks    = new TasksApi(apiClient);
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run tests with coverage
+npm test
+```
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "dalux-build-api",
+  "version": "1.0.0",
+  "description": "Node.js client for the Dalux Build API",
+  "main": "src/index.js",
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "jest --coverage",
+    "build": "npm pack",
+    "pack:check": "npm pack --dry-run",
+    "release:check": "npm test && npm run pack:check"
+  },
+  "keywords": [
+    "dalux",
+    "build",
+    "api",
+    "client",
+    "construction"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bruadam/Dalux-Build-API.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bruadam/Dalux-Build-API/issues"
+  },
+  "homepage": "https://github.com/bruadam/Dalux-Build-API#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "axios": "^1.7.7"
+  },
+  "devDependencies": {
+    "axios-mock-adapter": "^2.1.0",
+    "jest": "^29.7.0"
+  },
+  "jest": {
+    "testEnvironment": "node"
+  }
+}

package/src/api/CompaniesApi.js

@@ -0,0 +1,60 @@
+'use strict';
+
+/**
+ * API methods for managing companies on a project.
+ */
+class CompaniesApi {
+  /**
+   * @param {import('../apiClient')} apiClient
+   */
+  constructor(apiClient) {
+    this._client = apiClient;
+  }
+
+  /**
+   * Get companies on a project.
+   * GET /3.1/projects/{projectId}/companies
+   * @param {string} projectId
+   * @param {object} [params]
+   * @returns {Promise<object>}
+   */
+  listProjectCompanies(projectId, params = {}) {
+    return this._client.get(`/3.1/projects/${projectId}/companies`, params);
+  }
+
+  /**
+   * Get a specific company on a project.
+   * GET /3.0/projects/{projectId}/companies/{companyId}
+   * @param {string} projectId
+   * @param {string} companyId
+   * @returns {Promise<object>}
+   */
+  getProjectCompany(projectId, companyId) {
+    return this._client.get(`/3.0/projects/${projectId}/companies/${companyId}`);
+  }
+
+  /**
+   * Add a company to a project.
+   * POST /3.1/projects/{projectId}/companies
+   * @param {string} projectId
+   * @param {object} body
+   * @returns {Promise<object>}
+   */
+  createProjectCompany(projectId, body) {
+    return this._client.post(`/3.1/projects/${projectId}/companies`, body);
+  }
+
+  /**
+   * Update a company on a project.
+   * PATCH /3.0/projects/{projectId}/companies/{companyId}
+   * @param {string} projectId
+   * @param {string} companyId
+   * @param {object} body
+   * @returns {Promise<object>}
+   */
+  updateProjectCompany(projectId, companyId, body) {
+    return this._client.patch(`/3.0/projects/${projectId}/companies/${companyId}`, body);
+  }
+}
+
+module.exports = CompaniesApi;

package/src/api/CompanyCatalogApi.js

@@ -0,0 +1,108 @@
+'use strict';
+
+/**
+ * API methods for the company catalog.
+ */
+class CompanyCatalogApi {
+  /**
+   * @param {import('../apiClient')} apiClient
+   */
+  constructor(apiClient) {
+    this._client = apiClient;
+  }
+
+  /**
+   * Get companies registered in the company catalog.
+   * GET /2.2/companyCatalog
+   * @param {object} [params]
+   * @returns {Promise<object>}
+   */
+  getCompanies(params = {}) {
+    return this._client.get('/2.2/companyCatalog', params);
+  }
+
+  /**
+   * Get a specific company from the catalog.
+   * GET /1.2/companyCatalog/{catalogCompanyId}
+   * @param {string} catalogCompanyId
+   * @returns {Promise<object>}
+   */
+  getCompany(catalogCompanyId) {
+    return this._client.get(`/1.2/companyCatalog/${catalogCompanyId}`);
+  }
+
+  /**
+   * Add a company to the catalog.
+   * POST /2.2/companyCatalog
+   * @param {object} body
+   * @returns {Promise<object>}
+   */
+  createCompany(body) {
+    return this._client.post('/2.2/companyCatalog', body);
+  }
+
+  /**
+   * Update a company in the catalog.
+   * PATCH /2.1/companyCatalog/{catalogCompanyId}
+   * @param {string} catalogCompanyId
+   * @param {object} body
+   * @returns {Promise<object>}
+   */
+  updateCompany(catalogCompanyId, body) {
+    return this._client.patch(`/2.1/companyCatalog/${catalogCompanyId}`, body);
+  }
+
+  /**
+   * Get metadata of a specific company from the catalog.
+   * GET /1.0/companyCatalog/{catalogCompanyId}/metadata
+   * @param {string} catalogCompanyId
+   * @returns {Promise<object>}
+   */
+  listCompanyMetadata(catalogCompanyId) {
+    return this._client.get(`/1.0/companyCatalog/${catalogCompanyId}/metadata`);
+  }
+
+  /**
+   * Get all metadata available for a PATCH company-catalog operation.
+   * GET /1.0/companyCatalog/{catalogCompanyId}/metadata/1.0/mappings
+   * @param {string} catalogCompanyId
+   * @returns {Promise<object>}
+   */
+  listCompanyMetadataMappings(catalogCompanyId) {
+    return this._client.get(`/1.0/companyCatalog/${catalogCompanyId}/metadata/1.0/mappings`);
+  }
+
+  /**
+   * Get available values for metadata in a PATCH company-catalog operation.
+   * GET /1.0/companyCatalog/{catalogCompanyId}/metadata/1.0/mappings/{key}/values
+   * @param {string} catalogCompanyId
+   * @param {string} key
+   * @returns {Promise<object>}
+   */
+  listCompanyMetadataValues(catalogCompanyId, key) {
+    return this._client.get(
+      `/1.0/companyCatalog/${catalogCompanyId}/metadata/1.0/mappings/${key}/values`,
+    );
+  }
+
+  /**
+   * Get all metadata available for a POST company-catalog operation.
+   * GET /1.0/companyCatalog/metadata/1.0/mappings
+   * @returns {Promise<object>}
+   */
+  listMetadataMappingsForCompanies() {
+    return this._client.get('/1.0/companyCatalog/metadata/1.0/mappings');
+  }
+
+  /**
+   * Get available values for metadata in a POST company-catalog operation.
+   * GET /1.0/companyCatalog/metadata/1.0/mappings/{key}/values
+   * @param {string} key
+   * @returns {Promise<object>}
+   */
+  listMetadataValuesForCompanies(key) {
+    return this._client.get(`/1.0/companyCatalog/metadata/1.0/mappings/${key}/values`);
+  }
+}
+
+module.exports = CompanyCatalogApi;

package/src/api/FileAreasApi.js

@@ -0,0 +1,37 @@
+'use strict';
+
+/**
+ * API methods for file areas on a project.
+ */
+class FileAreasApi {
+  /**
+   * @param {import('../apiClient')} apiClient
+   */
+  constructor(apiClient) {
+    this._client = apiClient;
+  }
+
+  /**
+   * Retrieve the file areas on the given project.
+   * GET /5.1/projects/{projectId}/file_areas
+   * @param {string} projectId
+   * @param {object} [params]
+   * @returns {Promise<object>}
+   */
+  getFileAreas(projectId, params = {}) {
+    return this._client.get(`/5.1/projects/${projectId}/file_areas`, params);
+  }
+
+  /**
+   * Retrieve a specific file area.
+   * GET /1.0/projects/{projectId}/file_areas/{fileAreaId}
+   * @param {string} projectId
+   * @param {string} fileAreaId
+   * @returns {Promise<object>}
+   */
+  getFileArea(projectId, fileAreaId) {
+    return this._client.get(`/1.0/projects/${projectId}/file_areas/${fileAreaId}`);
+  }
+}
+
+module.exports = FileAreasApi;

package/src/api/FileRevisionsApi.js

@@ -0,0 +1,31 @@
+'use strict';
+
+/**
+ * API methods for file revision content.
+ */
+class FileRevisionsApi {
+  /**
+   * @param {import('../apiClient')} apiClient
+   */
+  constructor(apiClient) {
+    this._client = apiClient;
+  }
+
+  /**
+   * Retrieve content of a specific file revision.
+   * GET /2.0/projects/{projectId}/file_areas/{fileAreaId}/files/{fileId}/revisions/{fileRevisionId}/content
+   * @param {string} projectId
+   * @param {string} fileAreaId
+   * @param {string} fileId
+   * @param {string} fileRevisionId
+   * @returns {Promise<Buffer>} Raw binary content
+   */
+  getFileRevisionContent(projectId, fileAreaId, fileId, fileRevisionId) {
+    return this._client.get(
+      `/2.0/projects/${projectId}/file_areas/${fileAreaId}/files/${fileId}/revisions/${fileRevisionId}/content`,
+      {},
+    );
+  }
+}
+
+module.exports = FileRevisionsApi;

package/src/api/FileUploadApi.js

@@ -0,0 +1,64 @@
+'use strict';
+
+/**
+ * API methods for chunked file uploads.
+ */
+class FileUploadApi {
+  /**
+   * @param {import('../apiClient')} apiClient
+   */
+  constructor(apiClient) {
+    this._client = apiClient;
+  }
+
+  /**
+   * Create a new upload slot and return a GUID pointing to that slot.
+   * POST /1.0/projects/{projectId}/file_areas/{fileAreaId}/upload
+   * @param {string} projectId
+   * @param {string} fileAreaId
+   * @param {object} body
+   * @returns {Promise<object>}
+   */
+  createUpload(projectId, fileAreaId, body) {
+    return this._client.post(
+      `/1.0/projects/${projectId}/file_areas/${fileAreaId}/upload`,
+      body,
+    );
+  }
+
+  /**
+   * Upload a part of a file.
+   * POST /1.0/projects/{projectId}/file_areas/{fileAreaId}/upload/{uploadGuid}
+   * @param {string} projectId
+   * @param {string} fileAreaId
+   * @param {string} uploadGuid
+   * @param {Buffer|Uint8Array} chunk - Binary file chunk
+   * @returns {Promise<object>}
+   */
+  uploadFilePart(projectId, fileAreaId, uploadGuid, chunk) {
+    return this._client.post(
+      `/1.0/projects/${projectId}/file_areas/${fileAreaId}/upload/${uploadGuid}`,
+      chunk,
+      {},
+      { headers: { 'Content-Type': 'application/octet-stream' } },
+    );
+  }
+
+  /**
+   * Finish uploading a file (finalize the upload).
+   * POST /2.0/projects/{projectId}/file_areas/{fileAreaId}/upload/{uploadGuid}/finalize
+   * @param {string} projectId
+   * @param {string} fileAreaId
+   * @param {string} uploadGuid
+   * @param {object} body
+   * @returns {Promise<object>}
+   */
+  finishUpload(projectId, fileAreaId, uploadGuid, body) {
+    return this._client.post(
+      `/2.0/projects/${projectId}/file_areas/${fileAreaId}/upload/${uploadGuid}/finalize`,
+      body,
+    );
+  }
+}
+
+module.exports = FileUploadApi;