Add client and service methods for getting CourseParticatipations f…

…or a referral

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({

server/paths/api.ts

@@ -81,6 +81,7 @@ export default {
   participations: {
     create: participationsPath,
     delete: participationPath,
+    referral: participationsPath.path('referral/:referralId'),
     show: participationPath,
     update: participationPath,
   },

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 })

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,