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)
    })
  })
})