Refactor: Generate HTML report detailing each supplier's configuration

Author: m-houston

package-lock.json

@@ -0,0 +1 @@
+supplier-reports/

packages/cli-supplier-reports/.gitignore

@@ -0,0 +1,67 @@
+# Supplier Reports CLI
+
+A command-line tool for generating HTML reports for NHS Notify suppliers showing their assigned pack specifications.
+
+## Installation
+
+This package is part of the nhs-notify-supplier-config monorepo. Install dependencies from the root:
+
+```bash
+npm install
+```
+
+## Usage
+
+```bash
+# Generate HTML reports for all suppliers
+npm run cli -- report -f specs.xlsx -o ./reports
+
+# Exclude draft packs from reports
+npm run cli -- report -f specs.xlsx -o ./reports --exclude-drafts
+
+# Generate a blank Excel template
+npm run cli -- template -o specs.template.xlsx
+
+# Force overwrite existing template
+npm run cli -- template -o specs.template.xlsx --force
+```
+
+### Commands
+
+#### `report`
+
+Generate HTML reports per supplier showing assigned pack specifications.
+
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--file` | `-f` | Excel file path | specifications.xlsx |
+| `--out` | `-o` | Output directory for HTML reports | ./supplier-reports |
+| `--exclude-drafts` | | Exclude supplier packs with DRAFT approval status | false |
+
+#### `template`
+
+Generate a blank Excel template with all required sheets and columns.
+
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--out` | `-o` | Output .xlsx file path | specifications.template.xlsx |
+| `--force` | `-F` | Overwrite existing file if present | false |
+
+## Report Features
+
+Each supplier report includes:
+
+- Supplier information (ID, name, channel type, daily capacity, status)
+- Volume group allocations with percentages
+- Summary cards showing pack counts by status
+- Table of contents with quick navigation
+- Detailed pack specifications including:
+  - Basic information
+  - Postage details
+  - Constraints
+  - Assembly specifications
+  - Paper details
+
+## Dependencies
+
+- `@nhs-notify/excel-parser` - For parsing Excel files

packages/cli-supplier-reports/README.md

@@ -0,0 +1,26 @@
+import type { Config } from "jest";
+
+const config: Config = {
+  moduleNameMapper: {
+    "^@supplier-config/cli-supplier-reports/(.*)$": "<rootDir>/src/$1",
+  },
+  preset: "ts-jest",
+  testEnvironment: "node",
+  testPathIgnorePatterns: ["/node_modules/", "/dist/"],
+  transform: {
+    "^.+\\.tsx?$": [
+      "@swc/jest",
+      {
+        jsc: {
+          parser: {
+            syntax: "typescript",
+            tsx: false,
+          },
+          target: "es2022",
+        },
+      },
+    ],
+  },
+};
+
+export default config;

packages/cli-supplier-reports/jest.config.ts

@@ -0,0 +1,32 @@
+{
+  "bin": {
+    "supplier-reports": "dist/cli.js"
+  },
+  "dependencies": {
+    "@nhsdigital/nhs-notify-event-schemas-supplier-config": "*",
+    "@supplier-config/excel-parser": "*",
+    "yargs": "^17.7.2"
+  },
+  "devDependencies": {
+    "@swc/core": "^1.11.13",
+    "@swc/jest": "^0.2.37",
+    "@tsconfig/node22": "^22.0.2",
+    "@types/jest": "^29.5.14",
+    "@types/yargs": "^17.0.32",
+    "jest": "^29.7.0",
+    "jest-mock-extended": "^3.0.7",
+    "typescript": "^5.9.3"
+  },
+  "name": "@supplier-config/cli-supplier-reports",
+  "private": true,
+  "scripts": {
+    "build": "tsc",
+    "cli": "ts-node src/cli.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "jest",
+    "test:unit": "jest",
+    "typecheck": "tsc --noEmit"
+  },
+  "version": "0.0.1"
+}