feat(cb2-13154): Provide a '‘centralDocs'' object for VTx

package.json

@@ -92,6 +92,7 @@
     "joi": "^17.12.1",
     "js-yaml": "^3.14.1",
     "lodash": "^4.17.21",
+    "@dvsa/cvs-microservice-common": "1.2.0",
     "moment": "^2.29.4",
     "moment-timezone": "^0.5.40",
     "node-yaml": "^4.0.1",

src/models/ITestResult.ts

@@ -88,6 +88,13 @@ export interface TestType {
   modificationTypeUsed?: string | null;
   particulateTrapFitted?: string | null;
   fuelType?: string | null;
+  centralDocs?: CentralDocs;
+}
+
+export interface CentralDocs {
+  issueRequired: boolean;
+  notes?: string;
+  reasonsForIssue: string[];
 }
 
 export interface Defect {

src/models/validators/SpecialistTestsCommonSchemaCancelled.ts

@@ -1,4 +1,5 @@
 import * as Joi from 'joi';
+import { string } from 'joi';
 import {
   defectsCommonSchema,
   testResultsCommonSchema,
@@ -45,6 +46,13 @@ export const testTypesCommonSchemaSpecialistTestsCancelled =
       .items(requiredStandardsSchema.required())
       .optional(),
     reapplicationDate: Joi.date().optional().allow(null, ''),
+    centralDocs: Joi.object()
+      .keys({
+        issueRequired: Joi.boolean().required(),
+        notes: Joi.string().optional(),
+        reasonsForIssue: Joi.array().items(string().optional()).required(),
+      })
+      .optional(),
   });
 
 export const testResultsCommonSchemaSpecialistTestsCancelled =

src/models/validators/SpecialistTestsCommonSchemaSubmitted.ts

@@ -1,4 +1,4 @@
-import * as Joi from 'joi';
+import Joi, { string } from 'joi';
 import {
   defectsCommonSchema,
   requiredStandardsSchema,
@@ -62,6 +62,13 @@ export const testTypesCommonSchemaSpecialistTestsSubmitted =
       .required(),
     requiredStandards: Joi.array().items(requiredStandardsSchema).optional(),
     reapplicationDate: Joi.date().optional().allow(null, ''),
+    centralDocs: Joi.object()
+      .keys({
+        issueRequired: Joi.boolean().required(),
+        notes: Joi.string().optional(),
+        reasonsForIssue: Joi.array().items(string().optional()).required(),
+      })
+      .optional(),
   });
 
 export const testResultsCommonSchemaSpecialistTestsSubmitted =

src/models/validators/TestResultsSchemaHGVCancelled.ts

@@ -1,5 +1,5 @@
 import * as Joi from 'joi';
-import { array } from 'joi';
+import { array, string } from 'joi';
 import {
   defectsCommonSchema,
   testTypesCommonSchema,
@@ -42,6 +42,13 @@ const testTypesSchema = testTypesCommonSchema.keys({
     .items(requiredStandardsSchema.required())
     .optional(),
   reapplicationDate: Joi.date().optional().allow(null, ''),
+  centralDocs: Joi.object()
+    .keys({
+      issueRequired: Joi.boolean().required(),
+      notes: Joi.string().optional(),
+      reasonsForIssue: Joi.array().items(string().optional()).required(),
+    })
+    .optional(),
 });
 
 export const hgvCancelled = testResultsCommonSchema.keys({

src/models/validators/TestResultsSchemaHGVSubmitted.ts

@@ -1,5 +1,5 @@
 import * as Joi from 'joi';
-import { array } from 'joi';
+import { array, string } from 'joi';
 import {
   defectsCommonSchema,
   testTypesCommonSchema,
@@ -42,6 +42,13 @@ const testTypesSchema = testTypesCommonSchema.keys({
     .items(requiredStandardsSchema.required())
     .optional(),
   reapplicationDate: Joi.date().optional().allow(null, ''),
+  centralDocs: Joi.object()
+    .keys({
+      issueRequired: Joi.boolean().required(),
+      notes: Joi.string().optional(),
+      reasonsForIssue: Joi.array().items(string().optional()).required(),
+    })
+    .optional(),
 });
 
 export const hgvSubmitted = testResultsCommonSchema.keys({

src/models/validators/TestResultsSchemaPSVCancelled.ts

@@ -1,5 +1,5 @@
 import * as Joi from 'joi';
-import { array } from 'joi';
+import { array, string } from 'joi';
 import {
   defectsCommonSchema,
   testTypesCommonSchema,
@@ -57,6 +57,13 @@ const testTypesSchema = testTypesCommonSchema.keys({
   modificationTypeUsed: Joi.string().max(100).allow(null),
   particulateTrapFitted: Joi.string().max(100).allow(null),
   reapplicationDate: Joi.date().optional().allow(null, ''),
+  centralDocs: Joi.object()
+    .keys({
+      issueRequired: Joi.boolean().required(),
+      notes: Joi.string().optional(),
+      reasonsForIssue: Joi.array().items(string().optional()).required(),
+    })
+    .optional(),
 });
 
 export const psvCancelled = testResultsCommonSchema.keys({

src/models/validators/TestResultsSchemaPSVSubmitted.ts

@@ -1,5 +1,5 @@
 import * as Joi from 'joi';
-import { array } from 'joi';
+import { array, string } from 'joi';
 import {
   defectsCommonSchema,
   testTypesCommonSchema,
@@ -57,6 +57,13 @@ const testTypesSchema = testTypesCommonSchema.keys({
   modificationTypeUsed: Joi.string().max(100).allow(null),
   particulateTrapFitted: Joi.string().max(100).allow(null),
   reapplicationDate: Joi.date().optional().allow(null, ''),
+  centralDocs: Joi.object()
+    .keys({
+      issueRequired: Joi.boolean().required(),
+      notes: Joi.string().optional(),
+      reasonsForIssue: Joi.array().items(string().optional()).required(),
+    })
+    .optional(),
 });
 
 export const psvSubmitted = testResultsCommonSchema.keys({

src/models/validators/TestResultsSchemaTRLCancelled.ts

@@ -1,5 +1,5 @@
 import * as Joi from 'joi';
-import { array } from 'joi';
+import { array, string } from 'joi';
 import {
   defectsCommonSchema,
   testTypesCommonSchema,
@@ -42,6 +42,13 @@ const testTypesSchema = testTypesCommonSchema.keys({
     .items(requiredStandardsSchema.required())
     .optional(),
   reapplicationDate: Joi.date().optional().allow(null, ''),
+  centralDocs: Joi.object()
+    .keys({
+      issueRequired: Joi.boolean().required(),
+      notes: Joi.string().optional(),
+      reasonsForIssue: Joi.array().items(string().optional()).required(),
+    })
+    .optional(),
 });
 
 export const trlCancelled = testResultsCommonSchema.keys({

src/models/validators/TestResultsSchemaTRLSubmitted.ts

@@ -1,5 +1,5 @@
 import * as Joi from 'joi';
-import { array } from 'joi';
+import { array, string } from 'joi';
 import {
   defectsCommonSchema,
   testTypesCommonSchema,
@@ -43,6 +43,13 @@ const testTypesSchema = testTypesCommonSchema.keys({
     .items(requiredStandardsSchema.required())
     .optional(),
   reapplicationDate: Joi.date().optional().allow(null, ''),
+  centralDocs: Joi.object()
+    .keys({
+      issueRequired: Joi.boolean().required(),
+      notes: Joi.string().optional(),
+      reasonsForIssue: Joi.array().items(string().optional()).required(),
+    })
+    .optional(),
 });
 
 export const trlSubmitted = testResultsCommonSchema.keys({

src/models/validators/test-types/testTypesSchemaDeskBasedTestsPut.ts

@@ -1,4 +1,5 @@
 import * as Joi from 'joi';
+import { string } from 'joi';
 import { requiredStandardsSchema } from '../CommonSchema';
 
 export const testTypesCommonSchemaDeskBasedTests = Joi.object().keys({
@@ -20,6 +21,13 @@ export const testTypesCommonSchemaDeskBasedTests = Joi.object().keys({
     .items(requiredStandardsSchema.required())
     .optional(),
   customDefects: Joi.array().max(0).allow(null),
+  centralDocs: Joi.object()
+    .keys({
+      issueRequired: Joi.boolean().required(),
+      notes: Joi.string().optional(),
+      reasonsForIssue: Joi.array().items(string()).optional(),
+    })
+    .optional(),
 });
 
 export const testTypesDeskBasedGroup1 =

src/models/validators/test-types/testTypesSchemaPut.ts

@@ -1,4 +1,5 @@
 import * as Joi from 'joi';
+import { string } from 'joi';
 import { defectsCommonSchema, requiredStandardsSchema } from '../CommonSchema';
 
 const additionalInformationSchema = Joi.object().keys({
@@ -64,6 +65,13 @@ export const testTypesCommonSchema = Joi.object()
     certificateLink: Joi.string().optional().allow(null),
     testTypeClassification: Joi.string().required(),
     deletionFlag: Joi.boolean().optional(),
+    centralDocs: Joi.object()
+      .keys({
+        issueRequired: Joi.boolean().required(),
+        notes: Joi.string().optional(),
+        reasonsForIssue: Joi.array().items(string()).optional(),
+      })
+      .optional(),
   })
   .required();
 

src/models/validators/test-types/testTypesSchemaSpecialistTestsPut.ts

@@ -1,4 +1,5 @@
 import * as Joi from 'joi';
+import { string } from 'joi';
 import { defectsCommonSchemaSpecialistTestsSubmitted } from '../SpecialistTestsCommonSchemaSubmitted';
 import { requiredStandardsSchema } from '../CommonSchema';
 
@@ -35,6 +36,13 @@ export const testTypesCommonSchemaSpecialistTests = Joi.object()
     lastUpdatedAt: Joi.string().optional(),
     certificateLink: Joi.string().optional(),
     testTypeClassification: Joi.string().required(),
+    centralDocs: Joi.object()
+      .keys({
+        issueRequired: Joi.boolean().required(),
+        notes: Joi.string().optional(),
+        reasonsForIssue: Joi.array().items(string()).optional(),
+      })
+      .optional(),
   })
   .required();
 

src/utils/validationUtil.ts

@@ -1,10 +1,12 @@
-import { ValidationResult, any, string } from 'joi';
+import { any, string, ValidationResult } from 'joi';
 import { isDate } from 'lodash';
+import { TestTypeHelper } from '@dvsa/cvs-microservice-common/classes/testTypes/testTypeHelper';
+import { CENTRAL_DOCS_TEST } from '@dvsa/cvs-microservice-common/classes/testTypes/Constants';
 import * as enums from '../assets/Enums';
 import * as models from '../models';
+import { TestType } from '../models';
 import * as validators from '../models/validators';
 import { MappingUtil } from './mappingUtil';
-import { TestType } from '../models';
 
 export class ValidationUtil {
   // #region [rgba(52, 152, 219, 0.15)]  Public Functions
@@ -49,6 +51,8 @@ export class ValidationUtil {
     //   this.ivaFailedHasRequiredFields(payload.testTypes);
     // }
 
+    this.validateCentralDocs(payload.testTypes);
+
     const validation: ValidationResult<any> | any | null = validationSchema
       ? validationSchema.validate(payload)
       : null;
@@ -569,4 +573,39 @@ export class ValidationUtil {
     //     throw new models.HTTPError(400, 'Failed IVA tests must have IVA Defects');
     //   }
   }
+
+  /**
+   * Validates central docs for an array of test types
+   * @param testTypes TestType[]
+   * @throws HTTPError with status 400 if validation fails
+   */
+  public static validateCentralDocs(testTypes: TestType[]): void {
+    testTypes.forEach((testType) => {
+      if (
+        TestTypeHelper.validateTestTypeIdInList(
+          CENTRAL_DOCS_TEST,
+          testType.testTypeId,
+        ) &&
+        !testType?.centralDocs
+      ) {
+        throw new models.HTTPError(
+          400,
+          `Central docs required for test type ${testType.testTypeId}`,
+        );
+      }
+      if (
+        !TestTypeHelper.validateTestTypeIdInList(
+          CENTRAL_DOCS_TEST,
+          testType.testTypeId,
+        ) &&
+        testType?.centralDocs
+      ) {
+        throw new models.HTTPError(
+          400,
+          `Central documents can not be issued for test type ${testType.testTypeId}`,
+        );
+      }
+      return true;
+    });
+  }
 }

tests/integration/postTestResults.intTest.ts

@@ -0,0 +1,37 @@
+import supertest from 'supertest';
+import { CENTRAL_DOCS_TEST } from '@dvsa/cvs-microservice-common/classes/testTypes/Constants';
+import { ITestResultPayload } from '../../src/models';
+import testResultsPostMock from '../resources/test-results-post.json';
+
+const url = 'http://localhost:3006/';
+const request = supertest(url);
+
+describe('postTestResults', () => {
+  context('when submitting a test result with central docs', () => {
+    it('should return 400 when central docs are required but missing', async () => {
+      const testResult =
+        testResultsPostMock[15] as unknown as ITestResultPayload;
+
+      testResult.testTypes[0].testTypeId = CENTRAL_DOCS_TEST.IDS[3];
+      delete testResult.testTypes[0].centralDocs;
+
+      const res = await request.post('test-results').send(testResult);
+
+      expect(res.status).toBe(400);
+      expect(res.body).toBe('Central docs required for test type 47');
+    });
+  });
+
+  context('when submitting an invalid test result', () => {
+    it('should return 400 for missing required fields', async () => {
+      const testResult =
+        testResultsPostMock[10] as unknown as ITestResultPayload;
+      delete testResult.testResultId;
+      const res = await request.post('test-results').send(testResult);
+
+      console.log(res);
+      expect(res.status).toBe(400);
+      expect(res.body.errors).toContain('"testResultId" is required');
+    });
+  });
+});