NHSDigital · tstephen-nhs · Mar 11, 2026 · Feb 27, 2026 · Feb 27, 2026 · Mar 4, 2026
diff --git a/.github/workflows/sam_package_code.yml b/.github/workflows/sam_package_code.yml
@@ -33,7 +33,7 @@ jobs:
           NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
           echo "//npm.pkg.github.com/:_authToken=${NODE_AUTH_TOKEN}" >> ~/.npmrc
-          echo "@NHSDigital:registry=https://npm.pkg.github.com" >> ~/.npmrc
+          echo "@nhsdigital:registry=https://npm.pkg.github.com" >> ~/.npmrc
 
       - name: make install
         run: |

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
@@ -27,18 +27,16 @@
   "devDependencies": {
     "@eslint/js": "^10.0.1",
     "@types/aws-lambda": "^8.10.161",
-    "@types/jest": "^30.0.0",
     "@types/node": "^25.3.5",
     "@typescript-eslint/eslint-plugin": "^8.56.1",
     "@typescript-eslint/parser": "^8.54.0",
     "eslint": "^10.0.2",
     "eslint-plugin-import-newlines": "^2.0.0",
     "globals": "^17.4.0",
-    "jest": "^30.2.0",
-    "jest-junit": "^16.0.0",
-    "ts-jest": "^29.4.6",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@vitest/coverage-v8": "^3.2.4"
   },
   "dependencies": {
     "esbuild": "^0.27.3"

diff --git a/packages/capabilityStatement/.vscode/launch.json b/packages/capabilityStatement/.vscode/launch.json
@@ -1,34 +1,22 @@
 {
-    // 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: Run current file",
             "request": "launch",
+            "program": "${workspaceFolder}/../../node_modules/vitest/vitest.mjs",
             "args": [
-                "--runInBand",
-                "--watchAll=false",
-                "--testNamePattern",
-                "${jest.testNamePattern}",
-                "--runTestsByPath",
-                "${jest.testFile}",
+                "run",
+                "${file}",
                 "--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"
             }
         }
     ]

diff --git a/packages/capabilityStatement/.vscode/settings.json b/packages/capabilityStatement/.vscode/settings.json
@@ -1,7 +1,3 @@
 {
-  "jest.jestCommandLine": "/workspaces/prescriptionsforpatients/node_modules/.bin/jest --no-cache",
-  "jest.nodeEnv": {
-    "POWERTOOLS_DEV": true,
-    "NODE_OPTIONS": "--experimental-vm-modules"
-  }
+  "vitest.commandLine": "POWERTOOLS_DEV=true /workspaces/prescriptionsforpatients/node_modules/.bin/vitest run --config vitest.config.ts"
 }
diff --git a/packages/capabilityStatement/jest.config.ts b/packages/capabilityStatement/jest.config.ts
diff --git a/packages/capabilityStatement/jest.debug.config.ts b/packages/capabilityStatement/jest.debug.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 --coverage --config vitest.config.ts",
     "lint": "eslint  --max-warnings 0 --fix --config ../../eslint.config.mjs .",
     "compile": "tsc",
     "test": "npm run compile && npm run unit"

diff --git a/packages/capabilityStatement/vitest.config.ts b/packages/capabilityStatement/vitest.config.ts
@@ -0,0 +1,5 @@
+import {createVitestConfig} from "../../vitest.default.config"
+
+export default createVitestConfig({
+  workspaceRoot: "../../"
+})
diff --git a/packages/common/utilities/jest.config.ts b/packages/common/utilities/jest.config.ts
diff --git a/packages/common/utilities/jest.debug.config.ts b/packages/common/utilities/jest.debug.config.ts
diff --git a/packages/common/utilities/package.json b/packages/common/utilities/package.json
@@ -8,7 +8,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 --coverage --config vitest.config.ts",
     "lint": "eslint  --max-warnings 0 --fix --config ../../../eslint.config.mjs .",
     "compile": "tsc",
     "test": "npm run compile && npm run unit"

diff --git a/packages/common/utilities/tests/config.test.ts b/packages/common/utilities/tests/config.test.ts
@@ -1,11 +1,49 @@
-import {createMockedPfPConfig, setupTestEnvironment, MockedPfPConfig} from "@pfp-common/testing"
 import {
+  vi,
   expect,
   describe,
   it,
   beforeEach,
   afterEach
 } from "@jest/globals"
+import {PfPConfig} from "../src/config"
+import type {SSMProvider} from "@aws-lambda-powertools/parameters/ssm"
+
+type MockedPfPConfig = {
+  pfpConfig: PfPConfig;
+  mockGet: ReturnType<typeof vi.fn>;
+}
+
+function setupTestEnvironment() {
+  const originalEnv = {...process.env}
+
+  const restoreEnvironment = () => {
+    process.env = originalEnv
+    vi.restoreAllMocks()
+  }
+
+  return {
+    originalEnv,
+    restoreEnvironment
+  }
+}
+
+function createMockedPfPConfig(nhsNumbers: Array<string> = []): MockedPfPConfig {
+  const mockGet = vi.fn()
+  const nhsNumbersString = nhsNumbers.join(",")
+  mockGet.mockResolvedValue(nhsNumbersString)
+
+  const mockSSMProvider = {
+    get: mockGet
+  } as unknown as SSMProvider
+
+  const pfpConfig = new PfPConfig(mockSSMProvider)
+
+  return {
+    pfpConfig,
+    mockGet
+  }
+}
 
 describe("PfPConfig", () => {
   const NHS_NUMBER = "1234567890"

diff --git a/packages/common/utilities/vitest.config.ts b/packages/common/utilities/vitest.config.ts
@@ -0,0 +1,9 @@
+import {createVitestConfig} from "../../../vitest.default.config"
+
+export default createVitestConfig({
+  workspaceRoot: "../../../",
+  aliasOverrides: {
+    "@pfp-common/utilities": "packages/common/utilities/src/index.ts",
+    "@pfp-common/utilities/config": "packages/common/utilities/src/config.ts"
+  }
+})
diff --git a/packages/distanceSelling/.vscode/launch.json b/packages/distanceSelling/.vscode/launch.json
@@ -1,34 +1,22 @@
 {
-    // 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: Run current file",
             "request": "launch",
+            "program": "${workspaceFolder}/../../node_modules/vitest/vitest.mjs",
             "args": [
-                "--runInBand",
-                "--watchAll=false",
-                "--testNamePattern",
-                "${jest.testNamePattern}",
-                "--runTestsByPath",
-                "${jest.testFile}",
+                "run",
+                "${file}",
                 "--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"
             }
         }
     ]

diff --git a/packages/distanceSelling/.vscode/settings.json b/packages/distanceSelling/.vscode/settings.json
@@ -1,7 +1,3 @@
 {
-  "jest.jestCommandLine": "/workspaces/prescriptionsforpatients/node_modules/.bin/jest --no-cache",
-  "jest.nodeEnv": {
-    "POWERTOOLS_DEV": true,
-    "NODE_OPTIONS": "--experimental-vm-modules"
-  }
+  "vitest.commandLine": "POWERTOOLS_DEV=true /workspaces/prescriptionsforpatients/node_modules/.bin/vitest run --config vitest.config.ts"
 }
diff --git a/packages/distanceSelling/jest.config.ts b/packages/distanceSelling/jest.config.ts
diff --git a/packages/distanceSelling/jest.debug.config.ts b/packages/distanceSelling/jest.debug.config.ts
diff --git a/packages/distanceSelling/package.json b/packages/distanceSelling/package.json
@@ -7,7 +7,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 --coverage --config vitest.config.ts",
     "lint": "eslint  --max-warnings 0 --fix --config ../../eslint.config.mjs .",
     "compile": "tsc",
     "test": "npm run compile && npm run unit"

diff --git a/packages/distanceSelling/vitest.config.ts b/packages/distanceSelling/vitest.config.ts
@@ -0,0 +1,5 @@
+import {createVitestConfig} from "../../vitest.default.config"
+
+export default createVitestConfig({
+  workspaceRoot: "../../"
+})
diff --git a/packages/enrichPrescriptions/.vscode/launch.json b/packages/enrichPrescriptions/.vscode/launch.json
@@ -1,34 +1,22 @@
 {
-  // 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: Run current file",
       "request": "launch",
+      "program": "${workspaceFolder}/../../node_modules/vitest/vitest.mjs",
       "args": [
-        "--runInBand",
-        "--watchAll=false",
-        "--testNamePattern",
-        "${jest.testNamePattern}",
-        "--runTestsByPath",
-        "${jest.testFile}",
+        "run",
+        "${file}",
         "--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"
       }
     }
   ]

diff --git a/packages/enrichPrescriptions/.vscode/settings.json b/packages/enrichPrescriptions/.vscode/settings.json
@@ -1,7 +1,3 @@
 {
-  "jest.jestCommandLine": "/workspaces/prescriptionsforpatients/node_modules/.bin/jest --no-cache",
-  "jest.nodeEnv": {
-    "POWERTOOLS_DEV": true,
-    "NODE_OPTIONS": "--experimental-vm-modules"
-  }
+  "vitest.commandLine": "POWERTOOLS_DEV=true /workspaces/prescriptionsforpatients/node_modules/.bin/vitest run --config vitest.config.ts"
 }
diff --git a/packages/enrichPrescriptions/jest.config.ts b/packages/enrichPrescriptions/jest.config.ts