feat(project): add new endpoint (#830)

src/resources/Projects/Project.ts

@@ -8,6 +8,7 @@ import {
     BaseProjectModel,
     ProjectResourceType,
     ListAssociatedProjectsModel,
+    UpdatedProjectResourceAssociationsModel,
 } from './ProjectInterfaces.js';
 
 export default class Project extends Resource {
@@ -109,4 +110,21 @@ export default class Project extends Resource {
             resourceIds,
         );
     }
+
+    /**
+     * Modifies project-resource associations and returns a list of updated projects.
+     *
+     * @param {ProjectResourceType} resourceType
+     * @param {UpdatedProjectResourceAssociationsModel} updatedProjectResourceAssociation
+     * @returns {Promise<ProjectModel[]>} Returns a list of updated projects.
+     */
+    updateProjectResourceAssociation(
+        resourceType: ProjectResourceType,
+        updatedProjectResourceAssociation: UpdatedProjectResourceAssociationsModel,
+    ): Promise<ProjectModel[]> {
+        return this.api.put<ProjectModel[]>(
+            this.buildPath(`${Project.baseUrl}/resources/modify/${resourceType}`),
+            updatedProjectResourceAssociation,
+        );
+    }
 }

src/resources/Projects/ProjectInterfaces.ts

@@ -138,3 +138,25 @@ export interface ListAssociatedProjectsModel {
      */
     projectIds: string[];
 }
+
+export interface UpdatedProjectAssociationsModel {
+    /**
+     * IDs of projects that are to be updated
+     */
+    projectIds: string[];
+    /**
+     * IDs of resources whose association with the precised project IDs is to be updated
+     */
+    resourceIds: string[];
+}
+
+export interface UpdatedProjectResourceAssociationsModel {
+    /**
+     * Project-resource associations to be added
+     */
+    additions: UpdatedProjectAssociationsModel[];
+    /**
+     * Project-resource associations to be removed
+     */
+    removals: UpdatedProjectAssociationsModel[];
+}

src/resources/Projects/tests/Project.spec.ts

@@ -1,6 +1,11 @@
 import API from '../../../APICore.js';
 import Project from '../Project.js';
-import {BaseProjectModel, ProjectModel, ProjectType} from '../ProjectInterfaces.js';
+import {
+    BaseProjectModel,
+    ProjectModel,
+    ProjectType,
+    UpdatedProjectResourceAssociationsModel,
+} from '../ProjectInterfaces.js';
 
 jest.mock('../../../APICore.js');
 
@@ -131,4 +136,24 @@ describe('Project', () => {
             ]);
         });
     });
+
+    describe('updateProjectResourceAssociation', () => {
+        it('should make a PUT call to the correct Project URL', () => {
+            const randomProjectResourceAssociation: UpdatedProjectResourceAssociationsModel = {
+                additions: [
+                    {
+                        projectIds: ['random-project-id'],
+                        resourceIds: ['random-source-id'],
+                    },
+                ],
+                removals: [],
+            };
+            project.updateProjectResourceAssociation('SOURCE', randomProjectResourceAssociation);
+            expect(api.put).toHaveBeenCalledTimes(1);
+            expect(api.put).toHaveBeenCalledWith(
+                `${Project.baseUrl}/resources/modify/SOURCE`,
+                randomProjectResourceAssociation,
+            );
+        });
+    });
 });