Add rankKey support to certification forms and exams

- Introduced rankKey field in Certification interface and payloads.
- Updated CertificationForm to handle rankKey input.
- Enhanced ScheduleExamModal to filter exams based on rank.
- Added getEligibleExams API query to fetch exams relevant to the application's rank.
- Updated related components and types to accommodate new rankKey functionality.

libs/api/src/lib/features/licensing/licensing-api.ts

@@ -21,6 +21,7 @@ import type {
   AssignableOfficer,
   DocumentDecision,
   DocumentReview,
+  EligibleExam,
   ExportResult,
   LicenseTemplate,
   Paginated,
@@ -565,6 +566,15 @@ export const licensingApi = baseApi
           error ? [] : [itemTag('LicenseApplication', id), listTag('ApplicationQueue')],
       }),
 
+      /**
+       * Exam sittings valid for this application's rank — what the
+       * schedule-exam picker offers, instead of every exam in the system.
+       */
+      getEligibleExams: builder.query<EligibleExam[], string>({
+        query: (id) => ({ url: `/license-application-review/${id}/eligible-exams` }),
+        providesTags: (_r, _e, id) => [itemTag('LicenseApplication', id)],
+      }),
+
       /** Places a candidate who has paid the examination fee into a sitting. */
       scheduleExam: builder.mutation<
         LicenseApplication,
@@ -963,6 +973,7 @@ export const {
   useApproveDocumentsMutation,
   useFinalApproveMutation,
   useRejectApplicationMutation,
+  useGetEligibleExamsQuery,
   useScheduleExamMutation,
   useRecordExamOutcomeMutation,
   useRetakeExamMutation,

libs/api/src/lib/features/licensing/licensing.types.ts

@@ -690,3 +690,13 @@ export interface IssuedLicense {
   verificationCode: string;
   certificateFileKey: string | null;
 }
+
+/** One sitting offered to a claimed examined-certificate application, scoped to its rank. */
+export interface EligibleExam {
+  id: string;
+  title: { en: string; am: string };
+  date: string;
+  venue: string;
+  status: string;
+  certification?: { id: string; name: { en: string; am: string }; rankKey: string | null };
+}