NHSDigital · wildjames · Apr 10, 2026 · Mar 31, 2026 · Mar 31, 2026 · Mar 31, 2026
diff --git a/jest.default.config.ts b/jest.default.config.ts
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
@@ -36,6 +36,7 @@
     "@types/aws-lambda": "^8.10.161",
     "@types/jest": "^30.0.0",
     "@types/node": "^25.5.0",
+    "@vitest/coverage-v8": "^3.2.4",
     "@typescript-eslint/eslint-plugin": "^8.57.2",
     "@typescript-eslint/parser": "^8.57.1",
     "aws-lambda": "^1.0.7",
@@ -48,6 +49,8 @@
     "jest-junit": "^16.0.0",
     "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.4",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.57.2"
   },

diff --git a/packages/capabilityStatement/.vscode/launch.json b/packages/capabilityStatement/.vscode/launch.json
@@ -1,35 +1,42 @@
 {
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
   "version": "0.2.0",
   "configurations": [
-      {
-          "type": "node",
-          "name": "vscode-jest-tests.v2",
-          "request": "launch",
-          "args": [
-              "--runInBand",
-              "--watchAll=false",
-              "--testNamePattern",
-              "${jest.testNamePattern}",
-              "--runTestsByPath",
-              "${jest.testFile}",
-              "--config",
-              "${workspaceFolder}/jest.debug.config.ts"
-          ],
-          "cwd": "${workspaceFolder}",
-          "console": "integratedTerminal",
-          "internalConsoleOptions": "neverOpen",
-          "disableOptimisticBPs": true,
-          "program": "${workspaceFolder}/../../node_modules/.bin/jest",
-          "windows": {
-              "program": "${workspaceFolder}/node_modules/jest/bin/jest"
-          },
-          "env": {
-              "POWERTOOLS_DEV": true,
-              "NODE_OPTIONS": "--experimental-vm-modules"
-          }
-      }
+        {
+            "type": "node",
+            "name": "vitest: all tests",
+            "request": "launch",
+            "program": "${workspaceFolder}/../../node_modules/vitest/vitest.mjs",
+            "args": [
+                "run",
+                "--config",
+                "${workspaceFolder}/vitest.config.ts"
+            ],
+            "cwd": "${workspaceFolder}",
+            "console": "integratedTerminal",
+            "internalConsoleOptions": "neverOpen",
+            "disableOptimisticBPs": true,
+            "env": {
+                "POWERTOOLS_DEV": "true"
+            }
+        },
+        {
+            "type": "node",
+            "name": "vitest: current file",
+            "request": "launch",
+            "program": "${workspaceFolder}/../../node_modules/vitest/vitest.mjs",
+            "args": [
+                "run",
+                "--config",
+                "${workspaceFolder}/vitest.config.ts",
+                "${file}"
+            ],
+            "cwd": "${workspaceFolder}",
+            "console": "integratedTerminal",
+            "internalConsoleOptions": "neverOpen",
+            "disableOptimisticBPs": true,
+            "env": {
+                "POWERTOOLS_DEV": "true"
+            }
+        }
   ]
 }
diff --git a/packages/capabilityStatement/.vscode/settings.json b/packages/capabilityStatement/.vscode/settings.json
@@ -1,7 +1,3 @@
 {
-  "jest.jestCommandLine": "/workspaces/eps-prescription-status-update-api/node_modules/.bin/jest --no-cache",
-  "jest.nodeEnv": {
-    "POWERTOOLS_DEV": true,
-    "NODE_OPTIONS": "--experimental-vm-modules"
-  }
+  "testing.automaticallyOpenPeekView": "never"
 }
diff --git a/packages/capabilityStatement/jest.config.ts b/packages/capabilityStatement/jest.config.ts
diff --git a/packages/capabilityStatement/package.json b/packages/capabilityStatement/package.json
@@ -7,7 +7,7 @@
   "license": "MIT",
   "type": "module",
   "scripts": {
-    "unit": "POWERTOOLS_DEV=true NODE_OPTIONS=--experimental-vm-modules jest --no-cache --coverage",
+    "unit": "POWERTOOLS_DEV=true vitest run --config vitest.config.ts --coverage",
     "lint": "eslint  --max-warnings 0 --fix --config ../../eslint.config.mjs .",
     "compile": "tsc",
     "test": "npm run compile && npm run unit",

diff --git a/packages/capabilityStatement/tests/test-handler.test.ts b/packages/capabilityStatement/tests/test-handler.test.ts
@@ -5,8 +5,8 @@ import {
   expect,
   describe,
   it,
-  jest
-} from "@jest/globals"
+  vi
+} from "vitest"
 import capabilityStatement from "../src/apim-medicines-prescriptionstatusupdate.json"
 import {mockAPIGatewayProxyEvent, mockContext} from "@psu-common/testing"
 
@@ -25,7 +25,7 @@ describe("Unit test for app handler", function () {
   })
 
   it("appends trace id's to the logger", async () => {
-    const mockAppendKeys = jest.spyOn(Logger.prototype, "appendKeys")
+    const mockAppendKeys = vi.spyOn(Logger.prototype, "appendKeys")
 
     await handler(mockAPIGatewayProxyEvent, mockContext)
 

diff --git a/packages/capabilityStatement/vitest.config.ts b/packages/capabilityStatement/vitest.config.ts
@@ -0,0 +1,6 @@
+import {defineConfig, mergeConfig} from "vitest/config"
+import defaultConfig from "../../vitest.default.config.ts"
+
+export default mergeConfig(defaultConfig, defineConfig({
+  root: "./"
+}))
diff --git a/packages/checkPrescriptionStatusUpdates/.vscode/launch.json b/packages/checkPrescriptionStatusUpdates/.vscode/launch.json
@@ -1,34 +1,39 @@
 {
-  // Use IntelliSense to learn about possible attributes.
-  // Hover to view descriptions of existing attributes.
-  // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
   "version": "0.2.0",
   "configurations": [
       {
           "type": "node",
-          "name": "vscode-jest-tests.v2",
+          "name": "vitest: all tests",
           "request": "launch",
+          "program": "${workspaceFolder}/../../node_modules/vitest/vitest.mjs",
           "args": [
-              "--runInBand",
-              "--watchAll=false",
-              "--testNamePattern",
-              "${jest.testNamePattern}",
-              "--runTestsByPath",
-              "${jest.testFile}",
+              "run",
               "--config",
-              "${workspaceFolder}/jest.debug.config.ts"
+              "${workspaceFolder}/vitest.config.ts"
           ],
           "cwd": "${workspaceFolder}",
           "console": "integratedTerminal",
           "internalConsoleOptions": "neverOpen",
-          "disableOptimisticBPs": true,
-          "program": "${workspaceFolder}/../../node_modules/.bin/jest",
-          "windows": {
-              "program": "${workspaceFolder}/node_modules/jest/bin/jest"
-          },
           "env": {
-              "POWERTOOLS_DEV": true,
-              "NODE_OPTIONS": "--experimental-vm-modules"
+              "POWERTOOLS_DEV": "true"
+          }
+      },
+      {
+          "type": "node",
+          "name": "vitest: current file",
+          "request": "launch",
+          "program": "${workspaceFolder}/../../node_modules/vitest/vitest.mjs",
+          "args": [
+              "run",
+              "--config",
+              "${workspaceFolder}/vitest.config.ts",
+              "${file}"
+          ],
+          "cwd": "${workspaceFolder}",
+          "console": "integratedTerminal",
+          "internalConsoleOptions": "neverOpen",
+          "env": {
+              "POWERTOOLS_DEV": "true"
           }
       }
   ]

diff --git a/packages/checkPrescriptionStatusUpdates/.vscode/settings.json b/packages/checkPrescriptionStatusUpdates/.vscode/settings.json
@@ -1,7 +1,3 @@
 {
-  "jest.jestCommandLine": "/workspaces/eps-prescription-status-update-api/node_modules/.bin/jest --no-cache",
-  "jest.nodeEnv": {
-    "POWERTOOLS_DEV": true,
-    "NODE_OPTIONS": "--experimental-vm-modules"
-  }
+  "testing.automaticallyOpenPeekView": "never"
 }
diff --git a/packages/checkPrescriptionStatusUpdates/jest.config.ts b/packages/checkPrescriptionStatusUpdates/jest.config.ts
diff --git a/packages/checkPrescriptionStatusUpdates/package.json b/packages/checkPrescriptionStatusUpdates/package.json
@@ -6,7 +6,7 @@
   "author": "NHS Digital",
   "license": "MIT",
   "scripts": {
-    "unit": "POWERTOOLS_DEV=true NODE_OPTIONS=--experimental-vm-modules jest --no-cache --coverage",
+    "unit": "POWERTOOLS_DEV=true vitest run --config vitest.config.ts --coverage",
     "lint": "eslint  --max-warnings 0 --fix --config ../../eslint.config.mjs .",
     "compile": "tsc",
     "test": "npm run compile && npm run unit",

diff --git a/packages/checkPrescriptionStatusUpdates/tests/testDynamoDBclient.test.ts b/packages/checkPrescriptionStatusUpdates/tests/testDynamoDBclient.test.ts
@@ -1,7 +1,7 @@
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /* eslint-disable max-len */
 import {buildQuery} from "../src/dynamoDBclient"
-import {expect, describe} from "@jest/globals"
+import {describe, expect, test} from "vitest"
 import {InputData} from "../src/types"
 
 type buildQueryTestData = {

diff --git a/packages/checkPrescriptionStatusUpdates/tests/testHander.test.ts b/packages/checkPrescriptionStatusUpdates/tests/testHander.test.ts
@@ -2,8 +2,10 @@ import {
   expect,
   describe,
   it,
-  jest
-} from "@jest/globals"
+  beforeEach,
+  vi,
+  type Mock
+} from "vitest"
 
 import {DynamoDBDocumentClient} from "@aws-sdk/lib-dynamodb"
 import {handler} from "../src/checkPrescriptionStatusUpdates"
@@ -24,13 +26,13 @@ const defaultItem = {
 
 describe("test handler", () => {
   beforeEach(() => {
-    jest.resetModules()
-    jest.clearAllMocks()
+    vi.resetModules()
+    vi.clearAllMocks()
   })
 
   it("respond with empty request and status 404 when no results returned by dynamodb", async () => {
     const mockReply = generateReply(0)
-    jest.spyOn(DynamoDBDocumentClient.prototype, "send").mockResolvedValue(mockReply as never)
+    vi.spyOn(DynamoDBDocumentClient.prototype, "send").mockResolvedValue(mockReply as never)
 
     const response = await handler(mockAPIGatewayProxyEvent, mockContext)
     expect(response.statusCode).toBe(404)
@@ -41,7 +43,7 @@ describe("test handler", () => {
 
   it("respond with success when data returned by dynamodb", async () => {
     const mockReply = generateReply(1)
-    jest.spyOn(DynamoDBDocumentClient.prototype, "send").mockResolvedValue(mockReply as never)
+    vi.spyOn(DynamoDBDocumentClient.prototype, "send").mockResolvedValue(mockReply as never)
 
     const response = await handler(mockAPIGatewayProxyEvent, mockContext)
     expect(response.statusCode).toBe(200)
@@ -52,7 +54,7 @@ describe("test handler", () => {
 
   it("respond with success and LastEvaluatedKey when paginated data returned by dynamodb", async () => {
     const mockReply = generateReply(5, false)
-    jest.spyOn(DynamoDBDocumentClient.prototype, "send").mockResolvedValue(mockReply as never)
+    vi.spyOn(DynamoDBDocumentClient.prototype, "send").mockResolvedValue(mockReply as never)
 
     const response = await handler(mockAPIGatewayProxyEvent, mockContext)
     expect(response.statusCode).toBe(200)
@@ -70,7 +72,7 @@ describe("test handler", () => {
 
   it("returns less than 5 results if that's all that's available", async () => {
     const mockReply = generateReply(3)
-    jest.spyOn(DynamoDBDocumentClient.prototype, "send").mockResolvedValue(mockReply as never)
+    vi.spyOn(DynamoDBDocumentClient.prototype, "send").mockResolvedValue(mockReply as never)
 
     const response = await handler(mockAPIGatewayProxyEvent, mockContext)
     expect(response.statusCode).toBe(200)
@@ -86,7 +88,7 @@ describe("test handler", () => {
 
   it("returns just more than 5 results", async () => {
     // 6 results in 2 calls, expecting 6 results
-    jest
+    vi
       .spyOn(DynamoDBDocumentClient.prototype, "send")
       .mockImplementationOnce(() => {
         return Promise.resolve(generateReply(3, false))
@@ -108,7 +110,7 @@ describe("test handler", () => {
   })
 
   it("returns just more than 5 results with pagination headers", async () => {
-    jest
+    vi
       .spyOn(DynamoDBDocumentClient.prototype, "send")
       .mockImplementationOnce(() => {
         const reply = generateReply(2, false)
@@ -129,7 +131,7 @@ describe("test handler", () => {
       .mockImplementationOnce(() => {
         return Promise.resolve(generateReply(2))
       })
-    const mockSend = DynamoDBDocumentClient.prototype.send as jest.Mock
+    const mockSend = DynamoDBDocumentClient.prototype.send as Mock
 
     const event = JSON.parse(JSON.stringify(mockAPIGatewayProxyEvent))
     event.headers["exclusivestartkey-prescriptionid"] = "prescriptionId1"
@@ -154,7 +156,7 @@ describe("test handler", () => {
 
   it("returns no more than 15 results", async () => {
     // >15 results (15 with pagination headers), expecting 15 results
-    jest.spyOn(DynamoDBDocumentClient.prototype, "send").mockImplementationOnce(() => {
+    vi.spyOn(DynamoDBDocumentClient.prototype, "send").mockImplementationOnce(() => {
       return Promise.resolve(generateReply(15, false))
     })
 
@@ -174,7 +176,7 @@ describe("test handler", () => {
 
   it("respond with failure when dynamodb throws exception", async () => {
     const mockReply = {}
-    jest.spyOn(DynamoDBDocumentClient.prototype, "send").mockRejectedValue(mockReply as never)
+    vi.spyOn(DynamoDBDocumentClient.prototype, "send").mockRejectedValue(mockReply as never)
 
     const response = await handler(mockAPIGatewayProxyEvent, mockContext)
     expect(response.statusCode).toBe(500)

diff --git a/packages/checkPrescriptionStatusUpdates/vitest.config.ts b/packages/checkPrescriptionStatusUpdates/vitest.config.ts
@@ -0,0 +1,9 @@
+import {defineConfig, mergeConfig} from "vitest/config"
+import defaultConfig from "../../vitest.default.config.ts"
+
+export default mergeConfig(defaultConfig, defineConfig({
+  root: "./",
+  test: {
+    setupFiles: ["./.jest/setEnvVars.js"]
+  }
+}))
diff --git a/packages/common/commonTypes/package.json b/packages/common/commonTypes/package.json
@@ -8,7 +8,7 @@
   "types": "lib/src/index.d.ts",
   "type": "module",
   "scripts": {
-    "unit": "jest",
+    "unit": "vitest run --config vitest.config.ts --coverage --passWithNoTests",
     "lint": "eslint  --max-warnings 0 --fix --config ../../../eslint.config.mjs .",
     "compile": "tsc",
     "test": "npm run compile && npm run unit",