@defra/forms-engine-plugin 4.7.2-alpha → 4.7.3

package/src/server/plugins/engine/components/FileUploadField.test.ts

@@ -1,1079 +0,0 @@
-import {
-  ComponentType,
-  type FileUploadFieldComponent,
-  type FormMetadata
-} from '@defra/forms-model'
-import Boom from '@hapi/boom'
-
-import { ComponentCollection } from '~/src/server/plugins/engine/components/ComponentCollection.js'
-import {
-  FileUploadField,
-  tempItemSchema
-} from '~/src/server/plugins/engine/components/FileUploadField.js'
-import {
-  getAnswer,
-  type Field
-} from '~/src/server/plugins/engine/components/helpers/components.js'
-import { FormModel } from '~/src/server/plugins/engine/models/FormModel.js'
-import { InvalidComponentStateError } from '~/src/server/plugins/engine/pageControllers/errors.js'
-import {
-  createPage,
-  type PageControllerClass
-} from '~/src/server/plugins/engine/pageControllers/helpers/pages.js'
-import { validationOptions as opts } from '~/src/server/plugins/engine/pageControllers/validationOptions.js'
-import { type Services } from '~/src/server/plugins/engine/types/index.js'
-import {
-  FileStatus,
-  UploadStatus,
-  type FormContext,
-  type UploadState
-} from '~/src/server/plugins/engine/types.js'
-import { type FormRequestPayload } from '~/src/server/routes/types.js'
-import definition from '~/test/form/definitions/file-upload-basic.js'
-import { getFormData, getFormState } from '~/test/helpers/component-helpers.js'
-
-describe('FileUploadField', () => {
-  let model: FormModel
-
-  const validTempState: UploadState = [
-    {
-      uploadId: '3075efea-e5de-476f-a0bf-9ae7ef56ca69',
-      status: {
-        uploadStatus: UploadStatus.pending,
-        metadata: {
-          retrievalKey: 'enrique.chase@defra.gov.uk'
-        },
-        form: {
-          file: {
-            fileId: 'fcb4f0f8-6862-4836-86dc-f56ff900b0ff',
-            filename: 'SampleJPGImage_30mbmb.jpg',
-            fileStatus: FileStatus.pending,
-            contentLength: 30789588,
-            errorMessage: 'The selected file has not fully uploaded'
-          }
-        },
-        numberOfRejectedFiles: 0
-      }
-    },
-    {
-      uploadId: 'c7e8c8f1-fa5b-4587-966a-96066c6356bb',
-      status: {
-        uploadStatus: UploadStatus.ready,
-        metadata: {
-          retrievalKey: 'enrique.chase@defra.gov.uk'
-        },
-        form: {
-          file: {
-            fileId: 'e1d6cf98-35a7-4f97-8a28-cdd2b115d8fa',
-            filename: 'virus.txt',
-            fileStatus: FileStatus.rejected,
-            contentLength: 9662,
-            errorMessage: 'The selected file contains a virus'
-          }
-        },
-        numberOfRejectedFiles: 1
-      }
-    },
-    {
-      uploadId: 'ec9f9b26-76c6-4ede-8aaa-3d4e02fe9984',
-      status: {
-        uploadStatus: UploadStatus.ready,
-        metadata: {
-          retrievalKey: 'enrique.chase@defra.gov.uk'
-        },
-        form: {
-          file: {
-            fileId: '71fb359c-dee7-4c2e-8701-239eb892765a',
-            filename: 'SampleJPGImage_20mbmb.jpg',
-            fileStatus: FileStatus.complete,
-            contentLength: 21348301
-          }
-        },
-        numberOfRejectedFiles: 0
-      }
-    }
-  ]
-
-  const validState: UploadState = [
-    {
-      uploadId: '3075efea-e5de-476f-a0bf-9ae7ef56ca69',
-      status: {
-        uploadStatus: UploadStatus.ready,
-        metadata: {
-          retrievalKey: 'enrique.chase@defra.gov.uk'
-        },
-        form: {
-          file: {
-            fileId: 'fcb4f0f8-6862-4836-86dc-f56ff900b0ff',
-            filename: 'SampleJPGImage_30mbmb.jpg',
-            fileStatus: FileStatus.complete,
-            contentLength: 30789588
-          }
-        },
-        numberOfRejectedFiles: 0
-      }
-    },
-    {
-      uploadId: 'c7e8c8f1-fa5b-4587-966a-96066c6356bb',
-      status: {
-        uploadStatus: UploadStatus.ready,
-        metadata: {
-          retrievalKey: 'enrique.chase@defra.gov.uk'
-        },
-        form: {
-          file: {
-            fileId: 'e1d6cf98-35a7-4f97-8a28-cdd2b115d8fa',
-            filename: 'error-messages.txt',
-            fileStatus: FileStatus.complete,
-            contentLength: 9662
-          }
-        },
-        numberOfRejectedFiles: 0
-      }
-    },
-    {
-      uploadId: 'ec9f9b26-76c6-4ede-8aaa-3d4e02fe9984',
-      status: {
-        uploadStatus: UploadStatus.ready,
-        metadata: {
-          retrievalKey: 'enrique.chase@defra.gov.uk'
-        },
-        form: {
-          file: {
-            fileId: '71fb359c-dee7-4c2e-8701-239eb892765a',
-            filename: 'SampleJPGImage_20mbmb.jpg',
-            fileStatus: FileStatus.complete,
-            contentLength: 21348301
-          }
-        },
-        numberOfRejectedFiles: 0
-      }
-    }
-  ]
-
-  beforeEach(() => {
-    model = new FormModel(definition, {
-      basePath: 'test'
-    })
-  })
-
-  describe('Defaults', () => {
-    let def: FileUploadFieldComponent
-    let page: PageControllerClass
-    let collection: ComponentCollection
-    let field: Field
-
-    beforeEach(() => {
-      def = {
-        title: 'Example file upload field',
-        shortDescription: 'Example file upload',
-        name: 'myComponent',
-        type: ComponentType.FileUploadField,
-        options: {},
-        schema: {}
-      } satisfies FileUploadFieldComponent
-
-      page = createPage(model, definition.pages[0])
-      collection = new ComponentCollection([def], { page, model })
-      field = collection.fields[0]
-    })
-
-    describe('Schema', () => {
-      it('uses component short description as label', () => {
-        const { formSchema } = collection
-        const { keys } = formSchema.describe()
-
-        expect(keys).toHaveProperty(
-          'myComponent',
-          expect.objectContaining({
-            flags: expect.objectContaining({
-              label: 'Example file upload'
-            })
-          })
-        )
-      })
-
-      it('uses component title as label', () => {
-        def = {
-          title: 'Example file upload field',
-          name: 'myComponent',
-          type: ComponentType.FileUploadField,
-          options: {},
-          schema: {}
-        } satisfies FileUploadFieldComponent
-
-        page = createPage(model, definition.pages[0])
-        collection = new ComponentCollection([def], { page, model })
-
-        const { formSchema } = collection
-        const { keys } = formSchema.describe()
-
-        expect(keys).toHaveProperty(
-          'myComponent',
-          expect.objectContaining({
-            flags: expect.objectContaining({
-              label: 'Example file upload field'
-            })
-          })
-        )
-      })
-
-      it('uses component name as keys', () => {
-        const { formSchema } = collection
-        const { keys } = formSchema.describe()
-
-        expect(field.keys).toEqual(['myComponent'])
-        expect(field.collection).toBeUndefined()
-
-        for (const key of field.keys) {
-          expect(keys).toHaveProperty(key)
-        }
-      })
-
-      it('is required by default', () => {
-        const { formSchema } = collection
-        const { keys } = formSchema.describe()
-
-        expect(keys).toHaveProperty(
-          'myComponent',
-          expect.objectContaining({
-            flags: expect.objectContaining({
-              presence: 'required'
-            })
-          })
-        )
-      })
-
-      it('is optional when configured', () => {
-        const collectionOptional = new ComponentCollection(
-          [{ ...def, options: { required: false } }],
-          { model }
-        )
-
-        const { formSchema } = collectionOptional
-        const { keys } = formSchema.describe()
-
-        expect(keys).toHaveProperty(
-          'myComponent',
-          expect.objectContaining({
-            flags: expect.objectContaining({
-              presence: 'optional'
-            })
-          })
-        )
-
-        const result = collectionOptional.validate(getFormData())
-        expect(result.errors).toBeUndefined()
-      })
-
-      it('accepts valid values', () => {
-        const result1 = collection.validate(getFormData(validState))
-        const result2 = tempItemSchema.validate(validTempState[0], opts)
-        const result3 = tempItemSchema.validate(validTempState[1], opts)
-        const result4 = tempItemSchema.validate(validTempState[2], opts)
-
-        expect(result1.errors).toBeUndefined()
-        expect(result2.error).toBeUndefined()
-        expect(result3.error).toBeUndefined()
-        expect(result4.error).toBeUndefined()
-      })
-
-      it('adds errors for empty value', () => {
-        const result = collection.validate(getFormData())
-
-        expect(result.errors).toEqual([
-          expect.objectContaining({
-            text: 'Select example file upload'
-          })
-        ])
-      })
-
-      it('adds errors for empty value with no shortDescription', () => {
-        def = {
-          title: 'Example file upload field',
-          name: 'myComponent',
-          type: ComponentType.FileUploadField,
-          options: {},
-          schema: {}
-        } satisfies FileUploadFieldComponent
-
-        collection = new ComponentCollection([def], { model })
-        const result = collection.validate(getFormData())
-
-        expect(result.errors).toEqual([
-          expect.objectContaining({
-            text: 'Select example file upload field'
-          })
-        ])
-      })
-
-      it('adds errors for invalid values', () => {
-        const result1 = collection.validate(getFormData(['invalid']))
-        const result2 = collection.validate(
-          // @ts-expect-error - Allow invalid param for test
-          getFormData({ unknown: 'invalid' })
-        )
-
-        expect(result1.errors).toBeTruthy()
-        expect(result2.errors).toBeTruthy()
-      })
-    })
-
-    describe('State', () => {
-      it('returns text from state', () => {
-        const state1 = getFormState(validState)
-        const state2 = getFormState(null)
-
-        const answer1 = getAnswer(field, state1)
-        const answer2 = getAnswer(field, state2)
-
-        expect(answer1).toBe('Uploaded 3 files')
-        expect(answer2).toBe('')
-      })
-
-      it('returns payload from state', () => {
-        const state1 = getFormState(validState)
-        const state2 = getFormState(null)
-
-        const payload1 = field.getFormDataFromState(state1)
-        const payload2 = field.getFormDataFromState(state2)
-
-        expect(payload1).toEqual(getFormData(validState))
-        expect(payload2).toEqual(getFormData())
-      })
-
-      it('returns value from state', () => {
-        const state1 = getFormState(validState)
-        const state2 = getFormState(null)
-
-        const value1 = field.getFormValueFromState(state1)
-        const value2 = field.getFormValueFromState(state2)
-
-        expect(value1).toBe(validState)
-        expect(value2).toBeUndefined()
-      })
-
-      it('returns context for conditions and form submission', () => {
-        const state1 = getFormState(validState)
-        const state2 = getFormState(null)
-
-        const value1 = field.getContextValueFromState(state1)
-        const value2 = field.getContextValueFromState(state2)
-
-        const { file: file1 } = validState[0].status.form
-        const { file: file2 } = validState[1].status.form
-        const { file: file3 } = validState[2].status.form
-
-        expect(value1).toEqual([file1.fileId, file2.fileId, file3.fileId])
-        expect(value2).toBeNull()
-      })
-
-      it('returns state from payload', () => {
-        const payload1 = getFormData(validState)
-        const payload2 = getFormData()
-
-        const value1 = field.getStateFromValidForm(payload1)
-        const value2 = field.getStateFromValidForm(payload2)
-
-        expect(value1).toEqual(getFormState(validState))
-        expect(value2).toEqual(getFormState(null))
-      })
-    })
-
-    describe('View model', () => {
-      it('sets Nunjucks component defaults', () => {
-        const viewModel = field.getViewModel(getFormData(validState))
-
-        expect(viewModel).toEqual(
-          expect.objectContaining({
-            label: { text: def.title },
-            name: 'file', // hardcoded to 'file' for CDP
-            id: 'myComponent',
-            value: '', // input type=file can't have a default value
-            upload: {
-              count: 3,
-              summaryList: {
-                classes: 'govuk-summary-list--long-key',
-                rows: [
-                  {
-                    key: {
-                      html: expect.stringContaining('SampleJPGImage_30mbmb.jpg')
-                    },
-                    value: {
-                      html: expect.stringContaining('Uploaded')
-                    },
-                    actions: {
-                      items: [
-                        {
-                          href: `/test/file-upload-component/${validState[0].status.form.file.fileId}/confirm-delete`,
-                          text: 'Remove',
-                          attributes: { id: 'myComponent__0' },
-                          classes: 'govuk-link--no-visited-state',
-                          visuallyHiddenText: 'SampleJPGImage_30mbmb.jpg'
-                        }
-                      ]
-                    }
-                  },
-                  {
-                    key: {
-                      html: expect.stringContaining('error-messages.txt')
-                    },
-                    value: {
-                      html: expect.stringContaining('Uploaded')
-                    },
-                    actions: {
-                      items: [
-                        {
-                          href: `/test/file-upload-component/${validState[1].status.form.file.fileId}/confirm-delete`,
-                          text: 'Remove',
-                          attributes: { id: 'myComponent__1' },
-                          classes: 'govuk-link--no-visited-state',
-                          visuallyHiddenText: 'error-messages.txt'
-                        }
-                      ]
-                    }
-                  },
-                  {
-                    key: {
-                      html: expect.stringContaining('SampleJPGImage_20mbmb.jpg')
-                    },
-                    value: {
-                      html: expect.stringContaining('Uploaded')
-                    },
-                    actions: {
-                      items: [
-                        {
-                          href: `/test/file-upload-component/${validState[2].status.form.file.fileId}/confirm-delete`,
-                          text: 'Remove',
-                          attributes: { id: 'myComponent__2' },
-                          classes: 'govuk-link--no-visited-state',
-                          visuallyHiddenText: 'SampleJPGImage_20mbmb.jpg'
-                        }
-                      ]
-                    }
-                  }
-                ]
-              }
-            },
-            multiple: true
-          })
-        )
-      })
-
-      it('sets Nunjucks component defaults (preview URL direct access)', () => {
-        const viewModel = field.getViewModel(
-          getFormData(validState),
-          undefined,
-
-          // Preview URL '?force'
-          { force: '' }
-        )
-
-        expect(viewModel).toEqual(
-          expect.objectContaining({
-            label: { text: def.title },
-            name: 'file', // hardcoded to 'file' for CDP
-            id: 'myComponent',
-            value: '', // input type=file can't have a default value
-            upload: {
-              count: 3,
-              summaryList: {
-                classes: 'govuk-summary-list--long-key',
-                rows: [
-                  {
-                    key: {
-                      html: expect.stringContaining('SampleJPGImage_30mbmb.jpg')
-                    },
-                    value: {
-                      html: expect.stringContaining('Uploaded')
-                    },
-                    actions: {
-                      items: []
-                    }
-                  },
-                  {
-                    key: {
-                      html: expect.stringContaining('error-messages.txt')
-                    },
-                    value: {
-                      html: expect.stringContaining('Uploaded')
-                    },
-                    actions: {
-                      items: []
-                    }
-                  },
-                  {
-                    key: {
-                      html: expect.stringContaining('SampleJPGImage_20mbmb.jpg')
-                    },
-                    value: {
-                      html: expect.stringContaining('Uploaded')
-                    },
-                    actions: {
-                      items: []
-                    }
-                  }
-                ]
-              }
-            }
-          })
-        )
-      })
-
-      it('sets Nunjucks component defaults with temp valid state', () => {
-        const viewModel = field.getViewModel(getFormData(validTempState))
-
-        expect(viewModel).toEqual(
-          expect.objectContaining({
-            label: { text: def.title },
-            name: 'file', // hardcoded to 'file' for CDP
-            id: 'myComponent',
-            value: '', // input type=file can't have a default value
-            upload: {
-              count: 1,
-              summaryList: {
-                classes: 'govuk-summary-list--long-key',
-                rows: [
-                  {
-                    key: {
-                      html: expect.stringContaining('SampleJPGImage_20mbmb.jpg')
-                    },
-                    value: {
-                      html: expect.stringContaining('Uploaded')
-                    },
-                    actions: {
-                      items: [
-                        {
-                          href: `/test/file-upload-component/${validState[2].status.form.file.fileId}/confirm-delete`,
-                          text: 'Remove',
-                          attributes: { id: 'myComponent__0' },
-                          classes: 'govuk-link--no-visited-state',
-                          visuallyHiddenText: 'SampleJPGImage_20mbmb.jpg'
-                        }
-                      ]
-                    }
-                  }
-                ]
-              }
-            },
-            multiple: true
-          })
-        )
-      })
-
-      it('sets Nunjucks component defaults with temp valid state with errors (on POST)', () => {
-        const viewModel = field.getViewModel(getFormData(validTempState), [])
-
-        expect(viewModel).toEqual(
-          expect.objectContaining({
-            label: { text: def.title },
-            name: 'file', // hardcoded to 'file' for CDP
-            id: 'myComponent',
-            value: '', // input type=file can't have a default value
-            upload: {
-              count: 1,
-              summaryList: {
-                classes: 'govuk-summary-list--long-key',
-                rows: [
-                  {
-                    key: {
-                      html: expect.stringContaining('SampleJPGImage_20mbmb.jpg')
-                    },
-                    value: {
-                      html: expect.stringContaining('Uploaded')
-                    },
-                    actions: {
-                      items: [
-                        {
-                          href: `/test/file-upload-component/${validState[2].status.form.file.fileId}/confirm-delete`,
-                          text: 'Remove',
-                          attributes: { id: 'myComponent__0' },
-                          classes: 'govuk-link--no-visited-state',
-                          visuallyHiddenText: 'SampleJPGImage_20mbmb.jpg'
-                        }
-                      ]
-                    }
-                  }
-                ]
-              }
-            },
-            multiple: true
-          })
-        )
-      })
-    })
-
-    describe('AllPossibleErrors', () => {
-      it('should return errors', () => {
-        const errors = field.getAllPossibleErrors()
-        expect(errors.baseErrors).not.toBeEmpty()
-        expect(errors.advancedSettingsErrors).not.toBeEmpty()
-      })
-    })
-  })
-
-  describe('Validation', () => {
-    describe.each([
-      {
-        description: 'Schema min and max',
-        component: {
-          title: 'Example file upload field',
-          name: 'myComponent',
-          type: ComponentType.FileUploadField,
-          options: {},
-          schema: {
-            min: 1,
-            max: 2
-          }
-        } satisfies FileUploadFieldComponent,
-        assertions: [
-          {
-            input: getFormData([]),
-            output: {
-              value: getFormData([]),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain at least 1 items'
-                })
-              ]
-            }
-          },
-          {
-            input: getFormData(validState),
-            output: {
-              value: getFormData(validState),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain less than or equal to 2 items'
-                })
-              ]
-            }
-          }
-        ]
-      },
-      {
-        description: 'Schema default min',
-        component: {
-          title: 'Example file upload field',
-          name: 'myComponent',
-          type: ComponentType.FileUploadField,
-          options: {},
-          schema: {}
-        } satisfies FileUploadFieldComponent,
-        assertions: [
-          {
-            input: getFormData([]),
-            output: {
-              value: getFormData([]),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain at least 1 items'
-                })
-              ]
-            }
-          }
-        ]
-      },
-      {
-        description: 'Schema length',
-        component: {
-          title: 'Example file upload field',
-          name: 'myComponent',
-          type: ComponentType.FileUploadField,
-          options: {},
-          schema: {
-            length: 4
-          }
-        } satisfies FileUploadFieldComponent,
-        assertions: [
-          {
-            input: getFormData([]),
-            output: {
-              value: getFormData([]),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain 4 items'
-                })
-              ]
-            }
-          },
-          {
-            input: getFormData(validState),
-            output: {
-              value: getFormData(validState),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain 4 items'
-                })
-              ]
-            }
-          },
-          {
-            input: getFormData([...validState, ...validState]),
-            output: {
-              value: getFormData([...validState, ...validState]),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain 4 items'
-                })
-              ]
-            }
-          }
-        ]
-      },
-      {
-        description: 'Optional',
-        component: {
-          title: 'Example file upload field',
-          name: 'myComponent',
-          type: ComponentType.FileUploadField,
-          options: {
-            required: false
-          },
-          schema: {}
-        } satisfies FileUploadFieldComponent,
-        assertions: [
-          {
-            input: getFormData([]),
-            output: {
-              value: getFormData([])
-            }
-          },
-          {
-            input: getFormData(),
-            output: {
-              value: getFormData()
-            }
-          }
-        ]
-      },
-      {
-        description: 'Optional schema min and max',
-        component: {
-          title: 'Example file upload field',
-          name: 'myComponent',
-          type: ComponentType.FileUploadField,
-          options: {
-            required: false
-          },
-          schema: {
-            min: 1,
-            max: 2
-          }
-        } satisfies FileUploadFieldComponent,
-        assertions: [
-          {
-            input: getFormData(),
-            output: {
-              value: getFormData()
-            }
-          },
-          {
-            input: getFormData([]),
-            output: {
-              value: getFormData([]),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain at least 1 items'
-                })
-              ]
-            }
-          },
-          {
-            input: getFormData(validState),
-            output: {
-              value: getFormData(validState),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain less than or equal to 2 items'
-                })
-              ]
-            }
-          }
-        ]
-      },
-      {
-        description: 'Optional schema length',
-        component: {
-          title: 'Example file upload field',
-          name: 'myComponent',
-          type: ComponentType.FileUploadField,
-          options: {
-            required: false
-          },
-          schema: {
-            length: 4
-          }
-        } satisfies FileUploadFieldComponent,
-        assertions: [
-          {
-            input: getFormData(),
-            output: {
-              value: getFormData()
-            }
-          },
-          {
-            input: getFormData([]),
-            output: {
-              value: getFormData([]),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain 4 items'
-                })
-              ]
-            }
-          },
-          {
-            input: getFormData(validState),
-            output: {
-              value: getFormData(validState),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain 4 items'
-                })
-              ]
-            }
-          },
-          {
-            input: getFormData([...validState, ...validState]),
-            output: {
-              value: getFormData([...validState, ...validState]),
-              errors: [
-                expect.objectContaining({
-                  text: 'Example file upload field must contain 4 items'
-                })
-              ]
-            }
-          }
-        ]
-      }
-    ])('$description', ({ component: def, assertions }) => {
-      let collection: ComponentCollection
-
-      beforeEach(() => {
-        collection = new ComponentCollection([def], { model })
-      })
-
-      it.each([...assertions])(
-        'validates custom example',
-        ({ input, output }) => {
-          const result = collection.validate(input)
-          expect(result).toEqual(output)
-        }
-      )
-    })
-  })
-
-  describe('onSubmit', () => {
-    let fileUploadField: FileUploadField
-    let mockRequest: FormRequestPayload
-    let mockMetadata: FormMetadata
-    let mockContext: FormContext
-    let mockPersistFiles: jest.Mock
-
-    beforeEach(() => {
-      // Create a FileUploadField instance
-      const componentDef: FileUploadFieldComponent = {
-        name: 'fileUpload',
-        title: 'Upload something',
-        type: ComponentType.FileUploadField,
-        options: {},
-        schema: {}
-      }
-
-      const page = model.pages.find((p) => p.path === '/file-upload-component')
-      fileUploadField = new FileUploadField(componentDef, {
-        model,
-        page
-      })
-
-      // Mock persistFiles
-      mockPersistFiles = jest.fn().mockResolvedValue(undefined)
-
-      // Mock request
-      mockRequest = {
-        app: {
-          model: {
-            services: {
-              formSubmissionService: {
-                persistFiles: mockPersistFiles
-              }
-            }
-          }
-        }
-      } as unknown as FormRequestPayload
-
-      // Mock metadata
-      mockMetadata = {
-        notificationEmail: 'test@example.com'
-      } as FormMetadata
-
-      // Mock context with state
-      mockContext = {
-        state: {
-          fileUpload: validState
-        }
-      } as unknown as FormContext
-    })
-
-    afterEach(() => {
-      jest.clearAllMocks()
-    })
-
-    it('should successfully persist files', async () => {
-      await fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-
-      expect(mockPersistFiles).toHaveBeenCalledTimes(1)
-      expect(mockPersistFiles).toHaveBeenCalledWith(
-        [
-          {
-            fileId: 'fcb4f0f8-6862-4836-86dc-f56ff900b0ff',
-            initiatedRetrievalKey: 'enrique.chase@defra.gov.uk'
-          },
-          {
-            fileId: 'e1d6cf98-35a7-4f97-8a28-cdd2b115d8fa',
-            initiatedRetrievalKey: 'enrique.chase@defra.gov.uk'
-          },
-          {
-            fileId: '71fb359c-dee7-4c2e-8701-239eb892765a',
-            initiatedRetrievalKey: 'enrique.chase@defra.gov.uk'
-          }
-        ],
-        'test@example.com'
-      )
-    })
-
-    it('should fail when notificationEmail is not set', async () => {
-      mockMetadata.notificationEmail = undefined
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.toThrow('Unexpected missing notificationEmail in metadata')
-    })
-
-    it('should fail when notificationEmail is empty string', async () => {
-      mockMetadata.notificationEmail = ''
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.toThrow('Unexpected missing notificationEmail in metadata')
-    })
-
-    it('should not call persistFiles when no files in state', async () => {
-      mockContext.state = {}
-
-      await fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-
-      expect(mockPersistFiles).not.toHaveBeenCalled()
-    })
-
-    it('should not call persistFiles when empty array in state', async () => {
-      mockContext.state = { fileUpload: [] }
-
-      await fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-
-      expect(mockPersistFiles).not.toHaveBeenCalled()
-    })
-
-    it('should throw Error when formSubmissionService is not available', async () => {
-      if (!mockRequest.app.model) {
-        throw new Error('Invalid test setup')
-      }
-
-      mockRequest.app.model.services = {} as unknown as Services
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.toThrow('No form submission service available in app model')
-    })
-
-    it('should throw InvalidComponentStateError when persistFiles throws 403 Forbidden', async () => {
-      const forbiddenError = Boom.forbidden('Invalid retrieval key')
-      mockPersistFiles.mockRejectedValue(forbiddenError)
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.toThrow(InvalidComponentStateError)
-
-      const error = await fileUploadField
-        .onSubmit(mockRequest, mockMetadata, mockContext)
-        .catch((e: unknown) => e)
-
-      expect(error).toBeInstanceOf(InvalidComponentStateError)
-      expect((error as InvalidComponentStateError).component).toBe(
-        fileUploadField
-      )
-      expect((error as InvalidComponentStateError).userMessage).toBe(
-        'There was a problem with your uploaded files. Re-upload them before submitting the form again.'
-      )
-    })
-
-    it('should throw InvalidComponentStateError when persistFiles throws 410 Gone', async () => {
-      const goneError = Boom.resourceGone('File has expired')
-      mockPersistFiles.mockRejectedValue(goneError)
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.toThrow(InvalidComponentStateError)
-
-      const error = await fileUploadField
-        .onSubmit(mockRequest, mockMetadata, mockContext)
-        .catch((e: unknown) => e)
-
-      expect(error).toBeInstanceOf(InvalidComponentStateError)
-      expect((error as InvalidComponentStateError).component).toBe(
-        fileUploadField
-      )
-      expect((error as InvalidComponentStateError).userMessage).toBe(
-        'There was a problem with your uploaded files. Re-upload them before submitting the form again.'
-      )
-    })
-
-    it('should throw InvalidComponentStateError when persistFiles throws 404 Not Found', async () => {
-      const notFoundError = Boom.notFound('File not found')
-      mockPersistFiles.mockRejectedValue(notFoundError)
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.toThrow(InvalidComponentStateError)
-
-      const error = await fileUploadField
-        .onSubmit(mockRequest, mockMetadata, mockContext)
-        .catch((e: unknown) => e)
-
-      expect(error).toBeInstanceOf(InvalidComponentStateError)
-      expect((error as InvalidComponentStateError).component).toBe(
-        fileUploadField
-      )
-      expect((error as InvalidComponentStateError).userMessage).toBe(
-        'There was a problem with your uploaded files. Re-upload them before submitting the form again.'
-      )
-    })
-
-    it('should re-throw other Boom errors without wrapping', async () => {
-      const serverError = Boom.internal('Internal server error')
-      mockPersistFiles.mockRejectedValue(serverError)
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.toThrow(serverError)
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.not.toThrow(InvalidComponentStateError)
-    })
-
-    it('should re-throw non-Boom errors without wrapping', async () => {
-      const genericError = new Error('Something went wrong')
-      mockPersistFiles.mockRejectedValue(genericError)
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.toThrow(genericError)
-
-      await expect(
-        fileUploadField.onSubmit(mockRequest, mockMetadata, mockContext)
-      ).rejects.not.toThrow(InvalidComponentStateError)
-    })
-  })
-})