Refactor: Publish configuration to eventbus

Author: m-houston

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,26 @@
+import type { Config } from "jest";
+
+const config: Config = {
+  moduleNameMapper: {
+    "^@supplier-config/cli-eventbus-publish/(.*)$": "<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-eventbus-publish/package.json

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