Merge pull request #837 from ministryofjustice/APG-314-d-acp-history

(APG-314d) Add client and service methods to call `course-participations/referral/{id}`
ministryofjustice · Jan 13, 2025 · a4fc71f · a4fc71f
2 parents 2f7df15 + f88250b
commit a4fc71f
Show file tree

Hide file tree

Showing 4 changed files with 36 additions and 0 deletions.
diff --git a/server/data/accreditedProgrammesApi/courseClient.ts b/server/data/accreditedProgrammesApi/courseClient.ts
@@ -130,6 +130,13 @@ export default class CourseClient {
     })) as Array<CourseParticipation>
   }
 
+  /* istanbul ignore next */
+  async findParticipationsByReferral(referralId: string): Promise<Array<CourseParticipation>> {
+    return (await this.restClient.get({
+      path: apiPaths.participations.referral({ referralId }),
+    })) as Array<CourseParticipation>
+  }
+
   /* istanbul ignore next */
   async updateCourse(courseId: Course['id'], courseUpdate: CourseCreateRequest): Promise<Course> {
     return (await this.restClient.put({

diff --git a/server/paths/api.ts b/server/paths/api.ts
@@ -81,6 +81,7 @@ export default {
   participations: {
     create: participationsPath,
     delete: participationPath,
+    referral: participationsPath.path('referral/:referralId'),
     show: participationPath,
     update: participationPath,
   },

diff --git a/server/services/courseService.test.ts b/server/services/courseService.test.ts
@@ -470,6 +470,23 @@ describe('CourseService', () => {
     })
   })
 
+  describe('getParticipationsByReferral', () => {
+    const referral = referralFactory.build()
+
+    it('returns a list of participations for a given referral', async () => {
+      const courseParticipations = courseParticipationFactory.buildList(2, { referralId: referral.id })
+
+      when(courseClient.findParticipationsByReferral).calledWith(referral.id).mockResolvedValue(courseParticipations)
+
+      const result = await service.getParticipationsByReferral(username, referral.id)
+
+      expect(result).toEqual(courseParticipations)
+
+      expect(courseClientBuilder).toHaveBeenCalledWith(systemToken)
+      expect(courseClient.findParticipationsByReferral).toHaveBeenCalledWith(referral.id)
+    })
+  })
+
   describe('presentCourseParticipation', () => {
     const addedByUser = userFactory.build({ name: 'john smith' })
     const courseParticipation = courseParticipationFactory.build({ addedBy: addedByUser.username })

diff --git a/server/services/courseService.ts b/server/services/courseService.ts
@@ -238,6 +238,17 @@ export default class CourseService {
     return courseClient.findParticipationsByPerson(prisonNumber)
   }
 
+  async getParticipationsByReferral(
+    username: Express.User['username'],
+    referralId: Referral['id'],
+  ): Promise<Array<CourseParticipation>> {
+    const hmppsAuthClient = this.hmppsAuthClientBuilder()
+    const systemToken = await hmppsAuthClient.getSystemClientToken(username)
+    const courseClient = this.courseClientBuilder(systemToken)
+
+    return courseClient.findParticipationsByReferral(referralId)
+  }
+
   async presentCourseParticipation(
     userToken: Express.User['token'],
     courseParticipation: CourseParticipation,