feature/IO-3587-Commision-Cut - Improved local email

_reference/localEmailViewer/README.md

@@ -1,7 +1,33 @@
-This will connect to your dockers local stack session and render the email in HTML.
+This app connects to your Docker LocalStack SES endpoint and gives you a local inbox-style viewer
+for generated emails.
+
+```shell
+npm start
+```
+
+Or:
 
 ```shell
 node index.js
 ```
 
-http://localhost:3334
+Open: http://localhost:3334
+
+Features:
+
+- Manual refresh
+- Live refresh with adjustable polling interval
+- Search across subject, addresses, preview text, and attachment names
+- Expand/collapse all messages
+- Rendered HTML, plain-text, and raw MIME views
+- Copy raw MIME source
+- New-message highlighting plus fetch timing and parse-error stats
+
+Optional environment variables:
+
+```shell
+PORT=3334
+SES_VIEWER_ENDPOINT=http://localhost:4566/_aws/ses
+SES_VIEWER_REFRESH_MS=10000
+SES_VIEWER_FETCH_TIMEOUT_MS=5000
+```

_reference/localEmailViewer/package.json

@@ -4,12 +4,13 @@
   "main": "index.js",
   "type": "module",
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "start": "node index.js",
+    "check": "node --check index.js"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
-  "description": "",
+  "description": "LocalStack SES email viewer for inspecting local outbound mail",
   "dependencies": {
     "express": "^5.1.0",
     "mailparser": "^3.7.4",