CCM-13787: create supplier mock for testing

infrastructure/terraform/components/api/README.md

@@ -78,6 +78,7 @@ No requirements.
 | <a name="module_sqs_letter_updates"></a> [sqs\_letter\_updates](#module\_sqs\_letter\_updates) | https://github.com/NHSDigital/nhs-notify-shared-modules/releases/download/3.0.6/terraform-sqs.zip | n/a |
 | <a name="module_sqs_supplier_allocator"></a> [sqs\_supplier\_allocator](#module\_sqs\_supplier\_allocator) | https://github.com/NHSDigital/nhs-notify-shared-modules/releases/download/3.0.6/terraform-sqs.zip | n/a |
 | <a name="module_supplier_allocator"></a> [supplier\_allocator](#module\_supplier\_allocator) | https://github.com/NHSDigital/nhs-notify-shared-modules/releases/download/v2.0.29/terraform-lambda.zip | n/a |
+| <a name="module_supplier_mock"></a> [supplier\_mock](#module\_supplier\_mock) | https://github.com/NHSDigital/nhs-notify-shared-modules/releases/download/v2.0.29/terraform-lambda.zip | n/a |
 | <a name="module_supplier_ssl"></a> [supplier\_ssl](#module\_supplier\_ssl) | https://github.com/NHSDigital/nhs-notify-shared-modules/releases/download/v2.0.26/terraform-ssl.zip | n/a |
 | <a name="module_update_letter_queue"></a> [update\_letter\_queue](#module\_update\_letter\_queue) | https://github.com/NHSDigital/nhs-notify-shared-modules/releases/download/v2.0.29/terraform-lambda.zip | n/a |
 | <a name="module_upsert_letter"></a> [upsert\_letter](#module\_upsert\_letter) | https://github.com/NHSDigital/nhs-notify-shared-modules/releases/download/v2.0.29/terraform-lambda.zip | n/a |

infrastructure/terraform/components/api/module_lambda_supplier_mock.tf

@@ -0,0 +1,71 @@
+module "supplier_mock" {
+  source = "https://github.com/NHSDigital/nhs-notify-shared-modules/releases/download/v2.0.29/terraform-lambda.zip"
+
+  function_name = "supplier_mock"
+  description   = "Mock the behaviour of a supplier"
+
+  aws_account_id = var.aws_account_id
+  component      = var.component
+  environment    = var.environment
+  project        = var.project
+  region         = var.region
+  group          = var.group
+
+  log_retention_in_days = var.log_retention_in_days
+  kms_key_arn           = module.kms.key_arn
+
+  iam_policy_document = {
+    body = data.aws_iam_policy_document.supplier_mock_lambda.json
+  }
+
+  function_s3_bucket      = local.acct.s3_buckets["lambda_function_artefacts"]["id"]
+  function_code_base_path = local.aws_lambda_functions_dir_path
+  function_code_dir       = "supplier-mock/dist"
+  function_include_common = true
+  handler_function_name   = "supplierMockHandler"
+  runtime                 = "nodejs22.x"
+  memory                  = 512
+  timeout                 = 29
+  log_level               = var.log_level
+
+  force_lambda_code_deploy = var.force_lambda_code_deploy
+  enable_lambda_insights   = false
+
+  log_destination_arn       = local.destination_arn
+  log_subscription_role_arn = local.acct.log_subscription_role_arn
+
+  lambda_env_vars = merge(local.common_lambda_env_vars, {
+    ENVIRONMENT               = var.environment
+    GET_LETTERS_FUNCTION_NAME = module.get_letters.function_name
+  })
+}
+
+data "aws_iam_policy_document" "supplier_mock_lambda" {
+  statement {
+    sid    = "KMSPermissions"
+    effect = "Allow"
+
+    actions = [
+      "kms:Decrypt",
+      "kms:GenerateDataKey",
+    ]
+
+    resources = [
+      module.kms.key_arn, ## Requires shared kms module
+    ]
+  }
+
+  statement {
+    sid    = "AllowInvokeLambda"
+    effect = "Allow"
+
+    actions = [
+      "lambda:InvokeFunction",
+    ]
+
+    resources = [
+      module.get_letters.function_arn,
+      module.patch_letter.function_arn
+    ]
+  }
+}

lambdas/supplier-mock/.gitignore

@@ -0,0 +1,5 @@
+coverage
+node_modules
+dist
+.reports
+.aws-sam

lambdas/supplier-mock/buildAndRun.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+npm run lambda-build
+sam build
+sam local invoke SupplierMockFunction --event event.json

lambdas/supplier-mock/event.json

@@ -0,0 +1,3 @@
+{
+  "name": "Vlasios"
+}

lambdas/supplier-mock/jest.config.ts

@@ -0,0 +1,69 @@
+export const baseJestConfig = {
+  preset: "ts-jest",
+  extensionsToTreatAsEsm: [".ts"],
+  transform: {
+    "^.+\\.ts$": [
+      "ts-jest",
+      {
+        useESM: true,
+      },
+    ],
+  },
+  transformIgnorePatterns: [
+    "node_modules/(?!(@nhsdigital/nhs-notify-event-schemas-supplier-config)/)",
+  ],
+
+  // 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__/"],
+  testPathIgnorePatterns: [".build"],
+  testMatch: ["**/?(*.)+(spec|test).[jt]s?(x)"],
+
+  // 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,
+      },
+    ],
+  ],
+
+  // The test environment that will be used for testing
+  testEnvironment: "jsdom",
+};
+
+const utilsJestConfig = {
+  ...baseJestConfig,
+
+  testEnvironment: "node",
+
+  coveragePathIgnorePatterns: [
+    ...(baseJestConfig.coveragePathIgnorePatterns ?? []),
+    "zod-validators.ts",
+  ],
+};
+
+export default utilsJestConfig;

lambdas/supplier-mock/package.json

@@ -0,0 +1,21 @@
+{
+  "dependencies": {
+    "@aws-sdk/client-api-gateway": "^3.1030.0",
+    "@aws-sdk/client-lambda": "^3.1030.0",
+    "@internal/helpers": "^0.1.0",
+    "aws-embedded-metrics": "^4.2.1",
+    "aws-lambda": "^1.0.7",
+    "pino": "^10.3.1",
+    "zod": "^4.3.6"
+  },
+  "name": "nhs-notify-supplier-api-supplier-mock",
+  "private": true,
+  "scripts": {
+    "lambda-build": "rm -rf dist && npx esbuild --bundle --minify --sourcemap --target=es2020 --platform=node --loader:.node=file --entry-names=[name] --outdir=dist src/index.ts",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test:unit": "jest",
+    "typecheck": "tsc --noEmit"
+  },
+  "version": "0.0.1"
+}

lambdas/supplier-mock/src/__tests__/supplier-mock.test.ts

@@ -0,0 +1,5 @@
+describe("Supplier Mock Lambda", () => {
+  test("should return a successful response", async () => {
+    expect(true).toBe(true);
+  });
+});

lambdas/supplier-mock/src/deps.ts

@@ -0,0 +1,21 @@
+import { Logger } from "pino";
+import { createLogger } from "@internal/helpers/src";
+import { LambdaClient } from "@aws-sdk/client-lambda";
+import { EnvVars, envVars } from "./env";
+
+export type Deps = {
+  logger: Logger;
+  env: EnvVars;
+  lambdaClient: LambdaClient;
+};
+
+export function createDependenciesContainer(): Deps {
+  const log = createLogger({ logLevel: envVars.PINO_LOG_LEVEL });
+  const lambdaClient = new LambdaClient();
+
+  return {
+    logger: log,
+    env: envVars,
+    lambdaClient,
+  };
+}

lambdas/supplier-mock/src/env.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+
+const EnvVarsSchema = z.object({
+  PINO_LOG_LEVEL: z.coerce.string().optional(),
+  ENVIRONMENT: z.string().optional(),
+  AWS_REGION: z.string().optional(),
+  GET_LETTERS_FUNCTION_NAME: z.string().optional(),
+});
+
+export type EnvVars = z.infer<typeof EnvVarsSchema>;
+
+export const envVars: EnvVars = EnvVarsSchema.parse(process.env);

lambdas/supplier-mock/src/index.ts

@@ -0,0 +1,7 @@
+import { createDependenciesContainer } from "./deps";
+import createHandler from "./supplier-mock";
+
+const containerPromise = createDependenciesContainer();
+
+// eslint-disable-next-line import-x/prefer-default-export
+export const supplierMockHandler = createHandler(containerPromise);

lambdas/supplier-mock/src/supplier-mock.ts

@@ -0,0 +1,84 @@
+/* eslint-disable sonarjs/no-commented-code */
+import { InvokeCommand } from "@aws-sdk/client-lambda";
+import { Deps } from "./deps";
+import { RequestHeaders } from "../../../tests/constants/request-headers";
+
+export default function createHandler(deps: Deps) {
+  return async () => {
+    deps.logger.info("Hello from the supplier mock lambda!");
+    // const envName = deps.env.ENVIRONMENT;
+    const envName = "pr535";
+    deps.logger.info("VLASIS - second log");
+    deps.logger.info(`Environment: ${envName}`);
+    deps.logger.info({
+      msg: `Environment: ${envName}`,
+    });
+    // const input: ListFunctionsRequest = {
+    //   MaxItems: 1000,
+    // };
+    // const command = new ListFunctionsCommand(input);
+    // deps.logger.info("VLASIS - Invoking ListFunctionsCommand");
+    // const response = await deps.lambdaClient.send(command);
+    // const functions: FunctionConfiguration[] = response.Functions ?? [];
+    // console.log(
+    //   "list of functions in my environment:",
+    //   functions
+    //     .map((fn) => fn.FunctionName)
+    //     .filter((fnName) => fnName?.includes(envName))
+    //     .join("\n"),
+    // );
+
+    // const getLettersLambdaResponse = await deps.lambdaClient.send(
+    //   new InvokeCommand({
+    //     FunctionName: `nhs-${envName}-supapi-getletters`,
+    //     InvocationType: "RequestResponse",
+    //     Payload: Buffer.from(JSON.stringify({ test: "VLASIS data" })),
+    //   }),
+    // );
+
+    deps.logger.info("Invoking get_letters lambda directly");
+
+    if (!deps.env.GET_LETTERS_FUNCTION_NAME) {
+      throw new Error("GET_LETTERS_FUNCTION_NAME is not configured");
+    }
+
+    const headers: RequestHeaders = {
+      "NHSD-Supplier-ID": "TestSupplier1",
+      "NHSD-Correlation-ID": "12345",
+      "X-Request-ID": "requestId1",
+    };
+
+    const invokeResponse = await deps.lambdaClient.send(
+      new InvokeCommand({
+        FunctionName: deps.env.GET_LETTERS_FUNCTION_NAME,
+        InvocationType: "RequestResponse",
+        Payload: Buffer.from(
+          JSON.stringify({
+            headers: {
+              "nhsd-supplier-id": headers["NHSD-Supplier-ID"],
+              "nhsd-correlation-id": headers["NHSD-Correlation-ID"],
+              "x-request-id": headers["X-Request-ID"],
+            },
+            queryStringParameters: null,
+            requestContext: {},
+          }),
+        ),
+      }),
+    );
+
+    const responsePayload = invokeResponse.Payload
+      ? JSON.parse(Buffer.from(invokeResponse.Payload).toString("utf8"))
+      : undefined;
+
+    deps.logger.info(
+      {
+        statusCode: responsePayload?.statusCode,
+        functionError: invokeResponse.FunctionError,
+      },
+      "Received response from get_letters lambda",
+    );
+    deps.logger.info({
+      body: responsePayload?.body,
+    });
+  };
+}

lambdas/supplier-mock/template.yaml

@@ -0,0 +1,13 @@
+AWSTemplateFormatVersion: "2010-09-09"
+Transform: AWS::Serverless-2016-10-31
+
+Resources:
+  SupplierMockFunction:
+    Type: AWS::Serverless::Function
+    Properties:
+      FunctionName: supplier_mock
+      Runtime: nodejs22.x
+      Handler: index.handler
+      CodeUri: dist
+      MemorySize: 512
+      Timeout: 29

lambdas/supplier-mock/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "ignoreDeprecations": "5.0"
+  },
+  "extends": "../../tsconfig.base.json",
+  "include": ["src/**/*", "jest.config.ts"]
+}