dalux-build-api 1.0.0 → 1.0.4

package/LICENSE

@@ -1,21 +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.
+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

@@ -1,300 +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
+# 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