hof 23.0.4-session-timeout-beta-2 → 23.0.5-aws-sdk-v2-beta

package/CHANGELOG.md

@@ -1,4 +1,10 @@
-## 2026-03-25, Version 23.0.4 (Stable), @PaolaDMadd-Pro
+## 2026-05-12, Version 23.0.5 (Stable), @gregwolversonHO
+
+### Changed
+- Replaced nodemailer-ses-transport library with @aws-sdk/client-sesv2 to remove dependency on deprecated aws-sdk-v2 library
+- Replaced usage of nodemailer-ses-transport in the [emailer ses client](./components/emailer/transports/ses.js).
+
+## 2026-04-16, Version 23.0.4 (Stable), @PaolaDMadd-Pro
 
 ### Fixed
 - Decoupled session timeout keep alive from analytics configuration.
@@ -16,7 +22,6 @@
   * `gaTagId` not set: default `connect-src 'self'` remains and GA region endpoints are absent.
 - Added frontend Jest coverage for timeout refresh behavior:
   * Success path (`$.get().done`) updates refresh time and calls controller.
-  * Failure path (`$.get().fail`) triggers a console.error and does not call controller.
 
 
 ## 2026-03-18, Version 23.0.3 (Stable), @vinodhasamiyappan-ho

package/README.md

@@ -1364,17 +1364,25 @@ The following transport options are available:
 
 #### `ses`
 
-[nodemailer-ses-transport](https://github.com/andris9/nodemailer-ses-transport)
+[nodemailer SES transport](https://nodemailer.com/transports/ses)
 
 ##### Options
 
 - `accessKeyId` <String>: AWS accessKeyId. Required.
-- `secretAccessKey` <String>: AWS accessKeyId. Required.
+- `secretAccessKey` <String>: AWS secret access key. Required.
 - `sessionToken` <String>
 - `region` <String>. Defaults to 'eu-west-1'.
-- `httpOptions` <String>
-- `rateLimit` <String>
-- `maxConnections` <String>
+- `httpOptions` <Object>: Optional top-level overrides passed to the AWS SDK v3 SES client.
+
+Requires `@aws-sdk/client-sesv2`.
+
+`rateLimit` and `maxConnections` are legacy options from `nodemailer-ses-transport` and are no longer used.
+
+##### Migration note (from `nodemailer-ses-transport`)
+
+- No config key changes are required for existing HOF `ses` transport users (`accessKeyId`, `secretAccessKey`, `sessionToken`, and `region` are still supported).
+- If you used `rateLimit` or `maxConnections`, move that control to your application layer (for example, queueing/rate-limiting before calling `send`).
+- `httpOptions` is treated as an optional object of top-level AWS SDK v3 SES client overrides.
 
 #### `debug`
 
@@ -1459,7 +1467,6 @@ From version 23.0.4 , session timeout keep alive is now independent of analytics
 When a user clicks **Stay on this page** in the timeout dialog:
 
 - If keep-alive succeeds:  session refresh timestamp is updated and the timeout countdown/controller is restarted.
-- If keep-alive fails: a ```console.error``` is flagged by default.
 
 
 ### Customising content in `pages.json`

package/components/emailer/transports/ses.js

@@ -1,6 +1,6 @@
 'use strict';
 
-const ses = require('nodemailer-ses-transport');
+const { SESv2Client, SendEmailCommand } = require('@aws-sdk/client-sesv2');
 
 module.exports = options => {
   if (!options.accessKeyId) {
@@ -10,27 +10,29 @@ module.exports = options => {
     throw new Error('Required option `secretAccessKey` not found.');
   }
 
-  const opts = {
+  const credentials = {
     accessKeyId: options.accessKeyId,
     secretAccessKey: options.secretAccessKey
   };
 
-  opts.region = options.region || 'eu-west-1';
-
   if (options.sessionToken) {
-    opts.sessionToken = options.sessionToken;
+    credentials.sessionToken = options.sessionToken;
   }
 
-  if (options.httpOptions) {
-    opts.httpOptions = options.httpOptions;
-  }
+  const clientOptions = {
+    region: options.region || 'eu-west-1',
+    credentials
+  };
 
-  if (options.rateLimit !== undefined) {
-    opts.rateLimit = options.rateLimit;
+  // Legacy v2-style http options are accepted as top-level client overrides.
+  if (options.httpOptions && typeof options.httpOptions === 'object') {
+    Object.assign(clientOptions, options.httpOptions);
   }
 
-  if (options.maxConnections !== undefined) {
-    opts.maxConnections = options.maxConnections;
-  }
-  return ses(opts);
+  return {
+    SES: {
+      sesClient: new SESv2Client(clientOptions),
+      SendEmailCommand
+    }
+  };
 };

package/frontend/themes/gov-uk/client-js/session-timeout-dialog.js

@@ -281,9 +281,6 @@ window.GOVUK.sessionDialog = {
       .done(function () {
         window.GOVUK.sessionDialog.timeSessionRefreshed = new Date();
         window.GOVUK.sessionDialog.controller();
-      })
-      .fail(function () {
-        console.error('Session refresh failed.');
       });
   },
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "hof",
   "description": "A bootstrap for HOF projects",
-  "version": "23.0.4-session-timeout-beta-2",
+  "version": "23.0.5-aws-sdk-v2-beta",
   "license": "MIT",
   "main": "index.js",
   "author": "HomeOffice",
@@ -34,6 +34,7 @@
     "postversion": "git push && git push --tags"
   },
   "dependencies": {
+    "@aws-sdk/client-sesv2": "^3.907.0",
     "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
     "aliasify": "^2.1.0",
@@ -80,7 +81,6 @@
     "morgan": "^1.10.1",
     "mustache": "^4.2.0",
     "nodemailer": "^6.10.1",
-    "nodemailer-ses-transport": "^1.5.1",
     "nodemailer-stub-transport": "^1.1.0",
     "notifications-node-client": "^8.2.1",
     "redis": "^3.1.2",

package/sandbox/apps/sandbox/translations/en/default.json

@@ -1,4 +1,9 @@
 {
+  "buttons": {
+    "edit": "Edit",
+    "delete": "Delete",
+    "find-address": "Find address"
+  },
   "errors": {
     "service-unavailable": {
       "contact": "You can email for more information"
@@ -101,6 +106,32 @@
       "label": "Which country are you based in?",
       "hint": "Start to type the country name and options will appear"
     },
+    "hasOtherName": {
+      "legend": "Have you been known by any other names?",
+      "options": {
+        "yes": {
+          "label": "Yes"
+        },
+        "no": {
+          "label": "No"
+        }
+      }
+    },
+    "otherFirstName": {
+      "label": "Other first name"
+    },
+    "otherSurname": {
+      "label": "Other surname"
+    },
+    "uk-address-postcode": {
+      "label": "Postcode"
+    },
+    "uk-address-select": {
+      "label": "Select the address"
+    },
+    "uk-address": {
+      "label": "Address"
+    },
     "appealStages": {
       "label": "Appeal stage",
       "hint": "Choose an appeal stage from the drop down menu",
@@ -155,12 +186,30 @@
     "phone-number": {
       "header": "Enter your phone number"
     },
+    "other-name": {
+      "header": "Other names"
+    },
+    "address-lookup": {
+      "edit": "Change",
+      "cantfind": "I can't find the address in the list",
+      "postcode-entered": "Postcode you entered: ",
+      "postcode-api": {
+        "not-found": "Sorry - we couldn't find any addresses for that postcode, enter your address manually",
+        "cant-connect": "Sorry - we couldn't connect to the postcode lookup service at this time, enter your address manually"
+      }
+    },
+    "name-details": {
+      "header": "Other names summary"
+    },
     "confirm": {
       "header": "Check your answers before submitting your application.",
       "sections": {
         "applicantsDetails": {
           "header": "Applicant's details"
         },
+        "addressLookup": {
+          "header": "Address lookup"
+        },
         "address": {
           "header": "Address"
         },
@@ -197,10 +246,10 @@
       "message": "We have cleared your information to keep it secure. Your information has not been saved."
     },
     "session-timeout-warning": {
-      "dialog-title": "{{^showSaveAndExit}}Your application will close soon{{/showSaveAndExit}}{{#showSaveAndExit}}You will be signed out soon{{/showSaveAndExit}}",
-      "dialog-text": "{{^showSaveAndExit}}If that happens, your progress will not be saved.{{/showSaveAndExit}}{{#showSaveAndExit}}Any answers you have saved will not be affected, but your progress on this page will not be saved.{{/showSaveAndExit}}",
-      "timeout-continue-button": "{{^showSaveAndExit}}Stay on this page{{/showSaveAndExit}}{{#showSaveAndExit}}Stay signed in{{/showSaveAndExit}}",
-      "dialog-exit-link": "{{^showSaveAndExit}}Exit this form{{/showSaveAndExit}}{{#showSaveAndExit}}Sign out{{/showSaveAndExit}}"
+      "dialog-title": "{% if showSaveAndExit %}You will be signed out soon{% endif %}{% if not showSaveAndExit %}Your application will close soon{% endif %}",
+      "dialog-text": "{% if showSaveAndExit %}Any answers you have saved will not be affected, but your progress on this page will not be saved.{% endif %}{% if not showSaveAndExit %}If that happens, your progress will not be saved.{% endif %}",
+      "timeout-continue-button": "{% if showSaveAndExit %}Stay signed in{% endif %}{% if not showSaveAndExit %}Stay on this page{% endif %}",
+      "dialog-exit-link": "{% if showSaveAndExit %}Sign out{% endif %}{% if not showSaveAndExit %}Exit this form{% endif %}"
     },
     "save-and-exit": {
       "header": "You have been signed out",
@@ -251,6 +300,25 @@
       "required": "Enter an international phone number",
       "internationalPhoneNumber": "Enter a valid international phone number"
     },
+    "hasOtherName": {
+      "required": "Select an option below and press continue"
+    },
+    "otherFirstName": {
+      "default": "Enter your other first name"
+    },
+    "otherSurname": {
+      "default": "Enter your other surname"
+    },
+    "uk-address-postcode": {
+      "required": "Enter a postcode",
+      "postcode": "Enter a real postcode"
+    },
+    "uk-address-select": {
+      "required": "Select an address from the list"
+    },
+    "uk-address": {
+      "required": "Enter your address"
+    },
     "complaintDetails": {
       "default": "Enter details about why you are making a complaint",
       "maxlength": "Keep to the {{maxlength}} character limit"