Refactor: Load configuration into dynamodb

Author: m-houston

package-lock.json

@@ -0,0 +1,47 @@
+# DynamoDB Load CLI
+
+A command-line tool for populating a DynamoDB table with NHS Notify supplier configuration data from an Excel file.
+
+## Installation
+
+This package is part of the nhs-notify-supplier-config monorepo. Install dependencies from the root:
+
+```bash
+npm install
+```
+
+## Usage
+
+```bash
+# From the package directory
+npm run cli -- -f specs.xlsx -t my-config-table -r eu-west-2
+
+# Dry run (preview items without writing)
+npm run cli -- -f specs.xlsx -t my-table --dry-run
+```
+
+### Options
+
+| Option | Alias | Description | Required |
+|--------|-------|-------------|----------|
+| `--file` | `-f` | Excel file path | No (default: specifications.xlsx) |
+| `--table` | `-t` | DynamoDB table name | Yes |
+| `--region` | `-r` | AWS region (fallback: AWS_REGION env) | No |
+| `--dry-run` | | Preview items without writing | No |
+
+## DynamoDB Table Design
+
+This tool uses a single-table design with the following PK/SK patterns:
+
+| Entity | PK | SK |
+|--------|----|----|
+| VolumeGroup | `VOLUME_GROUP` | `<volumeGroupId>` |
+| Supplier | `SUPPLIER` | `<supplierId>` |
+| PackSpecification | `PACK_SPECIFICATION` | `<packSpecificationId>` |
+| LetterVariant | `LETTER_VARIANT` | `<letterVariantId>` |
+| SupplierAllocation | `SUPPLIER_ALLOCATION` | `<allocationId>` |
+| SupplierPack | `SUPPLIER_PACK` | `<supplierPackId>` |
+
+## Dependencies
+
+- `@nhs-notify/excel-parser` - For parsing Excel files

packages/cli-dynamodb-load/README.md

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

packages/cli-dynamodb-load/jest.config.ts

@@ -0,0 +1,35 @@
+{
+  "bin": {
+    "dynamodb-load": "dist/cli.js"
+  },
+  "dependencies": {
+    "@aws-sdk/client-dynamodb": "^3.969.0",
+    "@aws-sdk/util-dynamodb": "^3.969.0",
+    "@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",
+    "testcontainers": "^11.11.0",
+    "typescript": "^5.9.3"
+  },
+  "name": "@supplier-config/cli-dynamodb-load",
+  "private": true,
+  "scripts": {
+    "build": "tsc",
+    "cli": "ts-node src/cli.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "jest",
+    "test:integration": "TESTCONTAINERS_RYUK_DISABLED=true jest --testPathPatterns=integration",
+    "test:unit": "jest --testPathIgnorePatterns=integration",
+    "typecheck": "tsc --noEmit"
+  },
+  "version": "0.0.1"
+}