CCM-12869: Tools for publishing supplier config to the event bus

.gitignore

@@ -26,3 +26,5 @@ dist
 
 .env
 /.envrc
+/specifications.xlsx
+~*

packages/cli-eventbus-publish/README.md

@@ -0,0 +1,63 @@
+# EventBus Publish CLI
+
+A command-line tool for publishing NHS Notify supplier configuration events to AWS EventBridge.
+
+## Installation
+
+This package is part of the nhs-notify-supplier-config monorepo. Install dependencies from the root:
+
+```bash
+npm install
+```
+
+## Usage
+
+```bash
+# Parse an Excel file and output JSON
+npm run cli -- parse -f specs.xlsx
+
+# Publish events to EventBridge
+npm run cli -- publish -f specs.xlsx -b my-bus -r eu-west-2
+
+# Dry run (build events without sending)
+npm run cli -- publish -f specs.xlsx -b my-bus --dry-run
+```
+
+### Commands
+
+#### `parse`
+
+Parse an Excel file and output the parsed data as JSON.
+
+| Option | Alias | Description | Default |
+|--------|-------|-------------|---------|
+| `--file` | `-f` | Excel file path | specifications.xlsx |
+
+#### `publish`
+
+Build and publish events to EventBridge.
+
+| Option | Alias | Description | Required |
+|--------|-------|-------------|----------|
+| `--file` | `-f` | Excel file path | No (default: specifications.xlsx) |
+| `--bus` | `-b` | EventBridge event bus name | Yes |
+| `--region` | `-r` | AWS region (fallback: AWS_REGION env) | No |
+| `--dry-run` | | Build events without sending | No |
+
+## Event Types Published
+
+Events are published in the following order:
+
+1. VolumeGroup events
+2. Supplier events
+3. PackSpecification events
+4. SupplierPack events
+5. LetterVariant events
+6. SupplierAllocation events
+
+Each event is assigned a sequence number to maintain ordering.
+
+## Dependencies
+
+- `@nhs-notify/event-builder` - For building events from domain objects
+- `@nhs-notify/excel-parser` - For parsing Excel files

packages/cli-eventbus-publish/jest.config.ts

@@ -0,0 +1,72 @@
+import type { Config } from "jest";
+
+const config: Config = {
+  preset: "ts-jest",
+
+  // Automatically clear mock calls, instances, contexts and results before every test
+  clearMocks: true,
+
+  // Indicates whether the coverage information should be collected while executing the test
+  collectCoverage: true,
+
+  // The directory where Jest should output its coverage files
+  coverageDirectory: "./.reports/unit/coverage",
+
+  // Indicates which provider should be used to instrument code for coverage
+  coverageProvider: "babel",
+
+  coverageThreshold: {
+    global: {
+      branches: 100,
+      functions: 100,
+      lines: 100,
+      statements: -10,
+    },
+  },
+
+  coveragePathIgnorePatterns: ["/__tests__/", "/cli.ts"],
+
+  // Use this configuration option to add custom reporters to Jest
+  reporters: [
+    "default",
+    [
+      "jest-html-reporter",
+      {
+        pageTitle: "Test Report",
+        outputPath: "./.reports/unit/test-report.html",
+        includeFailureMsg: true,
+      },
+    ],
+  ],
+
+  moduleNameMapper: {
+    "^@supplier-config/cli-eventbus-publish/(.*)$": "<rootDir>/src/$1",
+    "^@supplier-config/event-builder/(.*)$":
+      "<rootDir>/../event-builder/src/$1",
+    "^@supplier-config/event-builder$":
+      "<rootDir>/../event-builder/src/index.ts",
+    "^@supplier-config/excel-parser/(.*)$": "<rootDir>/../excel-parser/src/$1",
+    "^@supplier-config/excel-parser$": "<rootDir>/../excel-parser/src/index.ts",
+  },
+
+  testEnvironment: "node",
+  testMatch: ["**/__tests__/**/*.ts", "**/?(*.)+(spec|test).ts"],
+  moduleFileExtensions: ["ts", "js", "json", "node"],
+  testPathIgnorePatterns: ["/node_modules/", "/dist/"],
+  transform: {
+    "^.+\\.tsx?$": [
+      "@swc/jest",
+      {
+        jsc: {
+          parser: {
+            syntax: "typescript",
+            tsx: false,
+          },
+          target: "es2022",
+        },
+      },
+    ],
+  },
+};
+
+export default config;

packages/cli-eventbus-publish/package.json

@@ -0,0 +1,33 @@
+{
+  "bin": {
+    "eventbus-publish": "dist/cli.js"
+  },
+  "dependencies": {
+    "@aws-sdk/client-eventbridge": "^3.592.0",
+    "@supplier-config/event-builder": "*",
+    "@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-eventbus-publish",
+  "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"
+}