@ministryofjustice/hmpps-probation-integration-e2e-tests 1.107.0 → 1.108.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ministryofjustice/hmpps-probation-integration-e2e-tests",
   "description": "Playwright end to end tests for hmpps-probation-integration-services.",
-  "version": "1.107.0",
+  "version": "1.108.0",
   "license": "MIT",
   "homepage": "https://github.com/ministryofjustice/hmpps-probation-integration-e2e-tests#readme",
   "bugs": {
@@ -12,23 +12,25 @@
     "url": "git+https://github.com/ministryofjustice/hmpps-probation-integration-e2e-tests.git"
   },
   "scripts": {
-    "build": "tsc && cp -r package.json dist"
+    "build": "tsdown && cp -r package.json dist"
   },
-  "type": "module",
-  "devDependencies": {
+  "dependencies": {
     "@faker-js/faker": "^10.0.0",
     "@kubernetes/client-node": "^1.0.0",
     "@playwright/test": "1.55.0",
+    "dotenv": "^17.0.0",
+    "luxon": "^3.5.0",
+    "node-stream-zip": "^1.15.0",
+    "pdf2json": "^3.1.4"
+  },
+  "devDependencies": {
     "@types/luxon": "^3.4.2",
     "@types/node": "^24.0.7",
     "@typescript-eslint/eslint-plugin": "^8.0.1",
     "@typescript-eslint/parser": "^8.0.1",
-    "dotenv": "^17.0.0",
     "eslint-config-prettier": "^10.0.1",
     "eslint-plugin-prettier": "^5.2.1",
-    "luxon": "^3.5.0",
-    "node-stream-zip": "^1.15.0",
-    "pdf2json": "^3.1.4",
-    "prettier": "3.6.2"
+    "prettier": "3.6.2",
+    "tsdown": "^0.15.2"
   }
 }

package/steps/accredited-programmes/application.d.mts

@@ -0,0 +1,19 @@
+import { Page } from "@playwright/test";
+
+//#region steps/accredited-programmes/application.d.ts
+declare function findProgrammeAndMakeReferral(page: Page, nomisId: string): Promise<void>;
+declare function clickOnOffenderLink(page: Page, linkName: string, fullName: string): Promise<void>;
+declare function verifyAssessmentDateTextToBe(page: Page, expectedText: string): Promise<void>;
+interface RoSHRiskAssertion {
+  riskToChildren: string;
+  riskToPublic: string;
+  riskToKnownAdult: string;
+  riskToStaff: string;
+  riskToPrisoners: string;
+}
+declare function assertRoSHRiskTable(page: Page, assertions: RoSHRiskAssertion): Promise<void>;
+declare const oasysImportDateText = "[data-testid=\"last-assessment-date-text\"]";
+declare const apFormattedTodayDate: string;
+declare const briefOffenceDetailsSummaryCard = "[data-testid=\"brief-offence-details-summary-card\"]";
+//#endregion
+export { apFormattedTodayDate, assertRoSHRiskTable, briefOffenceDetailsSummaryCard, clickOnOffenderLink, findProgrammeAndMakeReferral, oasysImportDateText, verifyAssessmentDateTextToBe };

package/steps/accredited-programmes/application.mjs

@@ -0,0 +1,80 @@
+import { formatDate } from "../delius/utils/date-time.mjs";
+import { expect } from "@playwright/test";
+import { DateTime } from "luxon";
+
+//#region steps/accredited-programmes/application.ts
+async function findProgrammeAndMakeReferral(page, nomisId) {
+	await page.getByRole("link", { name: "Find a programme and make a referral" }).click();
+	await expect(page).toHaveTitle(/Find recommended programmes - Accredited Programmes - DPS/);
+	await page.getByLabel("Enter a prison number to check what programmes are recommended based on the person's risks and needs.").fill(nomisId);
+	await page.getByRole("button", { name: /Continue/ }).click();
+	await expect(page).toHaveTitle(/Accredited Programmes - DPS/);
+	await page.getByRole("button", { name: /See all programmes/ }).click();
+	await page.getByRole("link", { name: "Becoming New Me Plus: general violence offence" }).click();
+	await expect(page).toHaveTitle(/Becoming New Me Plus: general violence offence programme description - DPS/);
+	await page.getByRole("cell", { name: "Moorland (HMP & YOI)" }).getByRole("link").click();
+	await expect(page).toHaveTitle(/Becoming New Me Plus: general violence offence programme/);
+	await page.getByRole("button", { name: /Make a referral/ }).click();
+	await expect(page).toHaveTitle(/Start referral - Accredited Programmes/);
+	await page.getByRole("button", { name: "Start now" }).click();
+	await expect(page).toHaveTitle(/Confirm person's details - Accredited Programmes/);
+	await page.getByRole("button", { name: /Continue/ }).click();
+	await expect(page).toHaveTitle(/Referral tasks to complete - Accredited Programmes/);
+	await page.getByRole("link", { name: "Review Accredited Programme history" }).click();
+	await expect(page).toHaveTitle(/Person's Accredited Programme history/);
+	await page.getByRole("button", { name: /Return to tasklist/ }).click();
+	await expect(page).toHaveTitle(/Referral tasks to complete - Accredited Programmes/);
+	await expect(page.locator("[data-testid=\"programme-history-tag\"]")).toContainText("Completed");
+	await page.getByRole("link", { name: "Check risks and needs information (OASys)" }).click();
+	await expect(page).toHaveTitle(/Check risks and needs information - Accredited Programmes/);
+	await page.getByRole("checkbox", { name: /I confirm that the OASys information is up to date./ }).click();
+	await page.getByRole("button", { name: /Continue/ }).click();
+	await expect(page).toHaveTitle(/Referral tasks to complete - Accredited Programmes/);
+	await expect(page.locator("[data-testid=\"confirm-oasys-tag\"]")).toContainText("Completed");
+	await page.getByRole("link", { name: "Add additional information" }).click();
+	await expect(page).toHaveTitle(/Add additional information - Accredited Programmes/);
+	await page.getByTestId("referrer-override-reason-text-area").fill("Test reason for the referral");
+	await page.getByTestId("additional-information-text-area").fill("Test additional information");
+	await page.getByRole("button", { name: /Continue/ }).click();
+	await expect(page).toHaveTitle(/Referral tasks to complete - Accredited Programmes/);
+	await expect(page.locator("[data-testid=\"additional-information-tag\"]")).toContainText("Completed");
+	await page.getByRole("link", { name: "Check answers and submit" }).click();
+	await expect(page).toHaveTitle(/Check your answers - Accredited Programmes/);
+	await page.getByLabel("I confirm the information I have provided is complete, accurate and up to date.").check();
+	await page.getByRole("button", { name: /Submit referral/ }).click();
+	await expect(page.locator("h1")).toContainText("Referral complete");
+	await page.getByRole("button", { name: /Go to my referrals/ }).click();
+	await expect(page).toHaveTitle(/My open referrals - Accredited Programmes/);
+}
+async function clickOnOffenderLink(page, linkName, fullName) {
+	await page.getByRole("link", { name: linkName }).click();
+	const nameLink = page.getByRole("link", { name: fullName });
+	if (!await nameLink.isVisible()) await page.getByRole("link", { name: linkName }).click();
+	await nameLink.click();
+}
+async function verifyAssessmentDateTextToBe(page, expectedText) {
+	const actualText = await page.locator(oasysImportDateText).first().evaluate((el) => el.textContent?.trim().replace(/\s+/g, " "));
+	expect(actualText).toBe(expectedText);
+}
+async function assertRoSHRiskTable(page, assertions) {
+	const selectors = {
+		riskToChildren: "tr:has(td:text(\"Children\")) td:nth-of-type(3)",
+		riskToPublic: "tr:has(td:text(\"Public\")) td:nth-of-type(3)",
+		riskToKnownAdult: "tr:has(td:text(\"Known adult\")) td:nth-of-type(3)",
+		riskToStaff: "tr:has(td:text(\"Staff\")) td:nth-of-type(3)",
+		riskToPrisoners: "tr:has(td:text(\"Prisoners\")) td:nth-of-type(3)"
+	};
+	for (const [key, expectedValue] of Object.entries(assertions)) {
+		const selector = selectors[key];
+		const cell = page.locator(selector);
+		await cell.waitFor();
+		const actualValue = await cell.textContent();
+		if (actualValue?.trim() !== expectedValue) throw new Error(`Expected "${expectedValue}" but found "${actualValue?.trim()}" for "${key}"`);
+	}
+}
+const oasysImportDateText = "[data-testid=\"last-assessment-date-text\"]";
+const apFormattedTodayDate = formatDate(DateTime.now(), "d MMMM yyyy");
+const briefOffenceDetailsSummaryCard = "[data-testid=\"brief-offence-details-summary-card\"]";
+
+//#endregion
+export { apFormattedTodayDate, assertRoSHRiskTable, briefOffenceDetailsSummaryCard, clickOnOffenderLink, findProgrammeAndMakeReferral, oasysImportDateText, verifyAssessmentDateTextToBe };

package/steps/accredited-programmes/login.d.mts

@@ -0,0 +1,6 @@
+import { Page } from "@playwright/test";
+
+//#region steps/accredited-programmes/login.d.ts
+declare const login: (page: Page) => Promise<void>;
+//#endregion
+export { login };

package/steps/accredited-programmes/login.mjs

@@ -0,0 +1,14 @@
+import { expect } from "@playwright/test";
+
+//#region steps/accredited-programmes/login.ts
+const login = async (page) => {
+	await page.goto(process.env.ACCREDITED_PROGRAMMES_URL);
+	await expect(page).toHaveTitle(/HMPPS Digital Services - Sign in/);
+	await page.fill("#username", process.env.DPS_USERNAME);
+	await page.fill("#password", process.env.DPS_PASSWORD);
+	await page.click("#submit");
+	await expect(page).toHaveTitle(/Accredited Programmes/);
+};
+
+//#endregion
+export { login };

package/steps/api/arns/arns-api.d.mts

@@ -0,0 +1,6 @@
+import * as playwright_core0 from "playwright-core";
+
+//#region steps/api/arns/arns-api.d.ts
+declare function getRisksFromArns(crn: string): Promise<playwright_core0.APIResponse>;
+//#endregion
+export { getRisksFromArns };

package/steps/api/arns/arns-api.mjs

@@ -0,0 +1,20 @@
+import { getToken } from "../auth/get-token.mjs";
+import { request } from "@playwright/test";
+
+//#region steps/api/arns/arns-api.ts
+async function getContext() {
+	const token = await getToken();
+	return request.newContext({
+		baseURL: process.env.ARNS_API,
+		extraHTTPHeaders: {
+			Accept: "application/json",
+			Authorization: `Bearer ${token}`
+		}
+	});
+}
+async function getRisksFromArns(crn) {
+	return await (await getContext()).get(`/risks/crn/${crn}`);
+}
+
+//#endregion
+export { getRisksFromArns };

package/steps/api/auth/get-token.d.mts

@@ -0,0 +1,4 @@
+//#region steps/api/auth/get-token.d.ts
+declare const getToken: () => Promise<any>;
+//#endregion
+export { getToken };

package/steps/api/auth/get-token.mjs

@@ -0,0 +1,14 @@
+import { request } from "@playwright/test";
+
+//#region steps/api/auth/get-token.ts
+const getToken = async () => {
+	const context = await request.newContext({ baseURL: process.env.AUTH_URL });
+	const creds = Buffer.from(`${process.env.HMPPS_AUTH_CLIENT_ID}:${process.env.HMPPS_AUTH_CLIENT_SECRET}`).toString("base64");
+	return (await (await context.post(`/auth/oauth/token?grant_type=client_credentials&username=${process.env.DPS_USERNAME}`, { headers: {
+		Accept: "application/json",
+		Authorization: `Basic ${creds}`
+	} })).json()).access_token;
+};
+
+//#endregion
+export { getToken };

package/steps/api/court-case/court-case-api.d.mts

@@ -0,0 +1,89 @@
+import * as playwright_core0 from "playwright-core";
+
+//#region steps/api/court-case/court-case-api.d.ts
+declare function addCourtHearing(hearing: CourtHearing): Promise<playwright_core0.APIResponse>;
+interface CourtHearing {
+  hearing: {
+    jurisdictionType: string;
+    courtCentre: {
+      code: string;
+      id: string;
+      roomId: string;
+      roomName: string;
+      name: string;
+    };
+    prosecutionCases: {
+      caseMarkers: {
+        markerTypeDescription: string;
+      }[];
+      defendants: {
+        offences: {
+          offenceLegislation: string;
+          offenceTitle: string;
+          offenceCode: string;
+          listingNumber: number;
+          judicialResults: {
+            resultText: string;
+            label: string;
+            judicialResultTypeId: string;
+            isConvictedResult: boolean;
+          }[];
+          verdict: {
+            verdictType: {
+              description: string;
+            };
+          };
+          id: string;
+          wording: string;
+          plea: {
+            pleaValue: string;
+          };
+          offenceDefinitionId: string;
+        }[];
+        id: string;
+        pncId: string;
+        prosecutionCaseId: string;
+        personDefendant: {
+          personDetails: {
+            firstName: string;
+            lastName: string;
+            address: {
+              address3: string;
+              address2: string;
+              address1: string;
+              postcode: string;
+              address5: string;
+            };
+            gender: string;
+            contact: {
+              work: string;
+              mobile: string;
+              email: string;
+              home: string;
+            };
+            dateOfBirth: string;
+            title: string;
+          };
+        };
+      }[];
+      initiationCode: string;
+      id: string;
+      prosecutionCaseIdentifier: {
+        caseURN: string;
+        prosecutionAuthorityId: string;
+        prosecutionAuthorityCode: string;
+      };
+    }[];
+    id: string;
+    type: {
+      description: string;
+      id: string;
+    };
+    hearingDays: {
+      sittingDay: string;
+      listedDurationMinutes: number;
+    }[];
+  };
+}
+//#endregion
+export { addCourtHearing };

package/steps/api/court-case/court-case-api.mjs

@@ -0,0 +1,24 @@
+import { getToken } from "../auth/get-token.mjs";
+import { request } from "@playwright/test";
+
+//#region steps/api/court-case/court-case-api.ts
+async function getContext() {
+	const token = await getToken();
+	return request.newContext({
+		baseURL: process.env.COURT_HEARING_EVENT_RECEIVER_URL,
+		extraHTTPHeaders: {
+			Accept: "application/json",
+			Authorization: `Bearer ${token}`
+		}
+	});
+}
+async function addCourtHearing(hearing) {
+	return await (await getContext()).post(`/hearing/${hearing.hearing.id}`, {
+		headers: { "content-type": "application/json" },
+		data: JSON.stringify(hearing),
+		failOnStatusCode: true
+	});
+}
+
+//#endregion
+export { addCourtHearing };

package/steps/api/cvl/cvl-api.d.mts

@@ -0,0 +1,6 @@
+//#region steps/api/cvl/cvl-api.d.ts
+declare const getLicenceIds: (...args: unknown[]) => Promise<any>;
+declare const discardAllLicences: (crn: string) => Promise<void>;
+declare const discardLicence: (...args: unknown[]) => Promise<void>;
+//#endregion
+export { discardAllLicences, discardLicence, getLicenceIds };

package/steps/api/cvl/cvl-api.mjs

@@ -0,0 +1,34 @@
+import { getToken } from "../auth/get-token.mjs";
+import { retry, sanitiseError } from "../utils/api-utils.mjs";
+import { request } from "@playwright/test";
+
+//#region steps/api/cvl/cvl-api.ts
+async function getContext() {
+	const token = await getToken();
+	return request.newContext({
+		baseURL: process.env.CVL_API,
+		extraHTTPHeaders: {
+			Accept: "application/json",
+			Authorization: `Bearer ${token}`
+		}
+	});
+}
+const getLicenceIds = retry(sanitiseError(async (crn) => {
+	return (await (await (await getContext()).get(`/public/licence-summaries/crn/${crn}`, { failOnStatusCode: true })).json()).filter((l) => l.statusCode !== "INACTIVE").map((l) => l.id);
+}));
+const discardAllLicences = async function(crn) {
+	const licenceIds = await getLicenceIds(crn);
+	for (const id of licenceIds) await discardLicence(id);
+};
+const discardLicence = retry(sanitiseError(async (licenceId) => {
+	await (await getContext()).post(`/licence/id/${licenceId}/override/status`, {
+		failOnStatusCode: true,
+		data: {
+			statusCode: "INACTIVE",
+			reason: "Testing"
+		}
+	});
+}));
+
+//#endregion
+export { discardAllLicences, discardLicence, getLicenceIds };

package/steps/api/dps/prison-api.d.mts

@@ -0,0 +1,38 @@
+import { Person } from "../../delius/utils/person.mjs";
+import { Page } from "@playwright/test";
+
+//#region steps/api/dps/prison-api.d.ts
+declare function createAndBookPrisoner(page: Page, crn: string, person: Person, prisonId?: string): Promise<{
+  nomisId: any;
+  bookingId: any;
+}>;
+declare function createAndBookPrisonerWithoutDeliusLink(page: Page, person: Person): Promise<{
+  nomisId: any;
+  bookingId: any;
+}>;
+declare const createPrisoner: (...args: unknown[]) => Promise<any>;
+declare const bookPrisoner: (...args: unknown[]) => Promise<any>;
+declare const releasePrisoner: (...args: unknown[]) => Promise<void>;
+declare const temporaryReleasePrisoner: (...args: unknown[]) => Promise<void>;
+declare const temporaryAbsenceReturn: (...args: unknown[]) => Promise<void>;
+declare const recallPrisoner: (...args: unknown[]) => Promise<void>;
+interface CustodyDates {
+  sentenceExpiryDate?: string;
+  confirmedReleaseDate?: string;
+  conditionalReleaseDate?: string;
+  conditionalReleaseOverrideDate?: string;
+  licenceExpiryDate?: string;
+  paroleEligibilityDate?: string;
+  topupSupervisionExpiryDate?: string;
+  homeDetentionCurfewEligibilityDate?: string;
+}
+declare const updateCustodyDates: (...args: unknown[]) => Promise<void>;
+interface Alert {
+  alertType?: string;
+  alertCode?: string;
+  comment?: string;
+  alertDate?: Date;
+}
+declare const createAnAlert: (...args: unknown[]) => Promise<void>;
+//#endregion
+export { Alert, CustodyDates, bookPrisoner, createAnAlert, createAndBookPrisoner, createAndBookPrisonerWithoutDeliusLink, createPrisoner, recallPrisoner, releasePrisoner, temporaryAbsenceReturn, temporaryReleasePrisoner, updateCustodyDates };

package/steps/api/dps/prison-api.mjs

@@ -0,0 +1,124 @@
+import { Yesterday } from "../../delius/utils/date-time.mjs";
+import { getToken } from "../auth/get-token.mjs";
+import { retry, sanitiseError } from "../utils/api-utils.mjs";
+import { setNomisId } from "../../delius/offender/update-offender.mjs";
+import { request } from "@playwright/test";
+import { DateTime } from "luxon";
+import { faker } from "@faker-js/faker";
+import { randomUUID } from "crypto";
+
+//#region steps/api/dps/prison-api.ts
+async function getContext() {
+	const token = await getToken();
+	return request.newContext({
+		baseURL: process.env.PRISON_API,
+		extraHTTPHeaders: {
+			Accept: "application/json",
+			Authorization: `Bearer ${token}`
+		}
+	});
+}
+async function createAndBookPrisoner(page, crn, person, prisonId = "SWI") {
+	const offenderNo = await createPrisoner(person);
+	await setNomisId(page, crn, offenderNo);
+	const bookingId = await bookPrisoner(offenderNo, prisonId);
+	console.log("NOMIS ID:", offenderNo);
+	console.log("Booking ID:", bookingId);
+	return {
+		nomisId: offenderNo,
+		bookingId
+	};
+}
+async function createAndBookPrisonerWithoutDeliusLink(page, person) {
+	const offenderNo = await createPrisoner(person);
+	const bookingId = await bookPrisoner(offenderNo);
+	console.log("NOMIS ID:", offenderNo);
+	console.log("Booking ID:", bookingId);
+	return {
+		nomisId: offenderNo,
+		bookingId
+	};
+}
+const createPrisoner = retry(sanitiseError(async (person) => {
+	return (await (await (await getContext()).post(`/api/offenders`, {
+		failOnStatusCode: true,
+		data: {
+			firstName: person.firstName,
+			lastName: person.lastName,
+			dateOfBirth: person.dob,
+			gender: person.sex.charAt(0),
+			pncNumber: person.pnc
+		}
+	})).json()).offenderNo;
+}));
+const bookPrisoner = retry(sanitiseError(async (offenderNo) => {
+	return (await (await (await getContext()).post(`/api/offenders/${offenderNo}/booking`, {
+		failOnStatusCode: true,
+		data: {
+			movementReasonCode: "N",
+			prisonId: "SWI",
+			imprisonmentStatus: "SENT03"
+		}
+	})).json()).bookingId;
+}));
+const releasePrisoner = retry(sanitiseError(async (offenderNo) => {
+	await (await getContext()).put(`/api/offenders/${offenderNo}/release`, {
+		failOnStatusCode: true,
+		data: { movementReasonCode: "CR" }
+	});
+}));
+const temporaryReleasePrisoner = retry(sanitiseError(async (offenderNo) => {
+	await (await getContext()).put(`/api/offenders/${offenderNo}/temporary-absence-out`, {
+		failOnStatusCode: true,
+		data: {
+			toCity: "18248",
+			transferReasonCode: "1"
+		}
+	});
+}));
+const temporaryAbsenceReturn = retry(sanitiseError(async (offenderNo) => {
+	await (await getContext()).put(`/api/offenders/${offenderNo}/temporary-absence-arrival`, {
+		failOnStatusCode: true,
+		data: {
+			agencyId: "SWI",
+			cellLocation: "SWI-RECP"
+		}
+	});
+}));
+const recallPrisoner = retry(sanitiseError(async (offenderNo) => {
+	await (await getContext()).put(`/api/offenders/${offenderNo}/recall`, {
+		failOnStatusCode: true,
+		data: {
+			prisonId: "SWI",
+			recallTime: DateTime.local().toISO({ includeOffset: false }),
+			movementReasonCode: "24"
+		}
+	});
+}));
+const updateCustodyDates = retry(sanitiseError(async (bookingId, custodyDates) => {
+	await (await getContext()).post(`/api/offender-dates/${bookingId}`, {
+		failOnStatusCode: true,
+		data: {
+			calculationUuid: randomUUID(),
+			submissionUser: process.env.DPS_USERNAME,
+			keyDates: custodyDates
+		}
+	});
+}));
+const createAnAlert = retry(sanitiseError(async (bookingId, { alertType, alertCode, comment, alertDate }) => {
+	await (await getContext()).post(`/api/bookings/${bookingId}/alert`, {
+		failOnStatusCode: true,
+		data: {
+			alertType,
+			alertCode,
+			comment,
+			alertDate: alertDate ?? faker.date.recent({
+				days: 1,
+				refDate: Yesterday.toJSDate()
+			})
+		}
+	});
+}));
+
+//#endregion
+export { bookPrisoner, createAnAlert, createAndBookPrisoner, createAndBookPrisonerWithoutDeliusLink, createPrisoner, recallPrisoner, releasePrisoner, temporaryAbsenceReturn, temporaryReleasePrisoner, updateCustodyDates };

package/steps/api/epf/epf-api.d.mts

@@ -0,0 +1,34 @@
+//#region steps/api/epf/epf-api.d.ts
+declare function epfContext(crn: string, eventNumber: string): Promise<Response>;
+interface Response {
+  name: Name;
+  dateOfBirth: Date;
+  gender: string;
+  courtAppearance: CourtAppearance;
+  sentence: Sentence;
+  responsibleProvider: ResponsibleProvider;
+  age: number;
+}
+interface Name {
+  forename: string;
+  middleName: string;
+  surname: string;
+}
+interface ResponsibleProvider {
+  code: string;
+  name: string;
+}
+interface CourtAppearance {
+  date: Date;
+  court: SentencingCourt;
+}
+interface Sentence {
+  date: Date;
+  sentencingCourt: SentencingCourt;
+  releaseDate: Date;
+}
+interface SentencingCourt {
+  name: string;
+}
+//#endregion
+export { CourtAppearance, Name, Response, ResponsibleProvider, Sentence, SentencingCourt, epfContext };

package/steps/api/epf/epf-api.mjs

@@ -0,0 +1,22 @@
+import { getToken } from "../auth/get-token.mjs";
+import { expect, request } from "@playwright/test";
+
+//#region steps/api/epf/epf-api.ts
+async function getContext() {
+	const token = await getToken();
+	return request.newContext({
+		baseURL: process.env.EPF_API,
+		extraHTTPHeaders: {
+			Accept: "application/json",
+			Authorization: `Bearer ${token}`
+		}
+	});
+}
+async function epfContext(crn, eventNumber) {
+	const response = await (await getContext()).get(`/case-details/${crn}/${eventNumber}`);
+	expect(response.ok()).toBeTruthy();
+	return response.json();
+}
+
+//#endregion
+export { epfContext };

package/steps/api/external-api/external-api.d.mts

@@ -0,0 +1,31 @@
+//#region steps/api/external-api/external-api.d.ts
+declare function getCaseDetails(crn: string): Promise<CaseDetails>;
+interface CaseDetails {
+  supervisions: Supervision[];
+}
+interface Supervision {
+  number: number;
+  active: boolean;
+  date: string;
+  sentence: Sentence;
+  mainOffence: Offence;
+  additionalOffences: Offence[];
+  courtAppearances: CourtAppearance[];
+}
+interface Sentence {
+  description: string;
+  date: string;
+  custodial: boolean;
+}
+interface Offence {
+  date: string;
+  code: string;
+  description: string;
+}
+interface CourtAppearance {
+  type: string;
+  date: string;
+  court: string;
+}
+//#endregion
+export { getCaseDetails };

package/steps/api/external-api/external-api.mjs

@@ -0,0 +1,22 @@
+import { getToken } from "../auth/get-token.mjs";
+import { expect, request } from "@playwright/test";
+
+//#region steps/api/external-api/external-api.ts
+async function getContext() {
+	const token = await getToken();
+	return request.newContext({
+		baseURL: process.env.EXTERNAL_API,
+		extraHTTPHeaders: {
+			Accept: "application/json",
+			Authorization: `Bearer ${token}`
+		}
+	});
+}
+async function getCaseDetails(crn) {
+	const response = await (await getContext()).get(`/case/${crn}/supervisions`);
+	expect(response.ok()).toBeTruthy();
+	return response.json();
+}
+
+//#endregion
+export { getCaseDetails };

package/steps/api/prison-identifier-and-delius/prison-identifier-and-delius.d.mts

@@ -0,0 +1,4 @@
+//#region steps/api/prison-identifier-and-delius/prison-identifier-and-delius.d.ts
+declare function triggerMatching(nomsNumber: string): Promise<void>;
+//#endregion
+export { triggerMatching };