Add AuthorizationRequired State

[zmaglica]

Fixes #7418

Changes proposed in this Pull Request

This PR adds Authentication required state that handles the situation when payment needs to be authorized (3DS). Among others, this PR introduces multiple state changes.

Testing instructions

• Make sure that all tests passed
• Make sure to test with a credit card that requires 3DS (4000000000003063)
• Make sure that you are redirected to the authorization URL.

---

• Run npm run changelog to add a changelog file, choose patch to leave it empty if the change is not significant. You can add multiple changelog files in one PR by running this command a few times.
• Covered with tests (or have a good reason not to test in description ☝️)
• Tested on mobile (or does not apply)

Post merge

• Link to testing instructions from release testing doc following these instructions : Add link here / 'QA Testing Not Applicable'
• Add or update critical flows and testing instructions for critical flows, if applicable.
• Add what's changed (description, screenshot, demo videos etc.) to the release announcement post, if applicable.

[RadoslavGeorgiev]

Great job so far, here's my initial feedback:

[zmaglica]

Great job so far, here's my initial feedback:

Thank you for the review. It really helped a lot. I have addressed all comments. Please let me know if there is anything to change or need additional feedback.

[RadoslavGeorgiev]

I like the direction of this PR, great job adjusting it to the concept! 👏

There are only a couple of topics I'd like to run by you in comments. In the meantime, feel free to proceed with the PR:

1. Basic checkout still works, but it would be nice to see the new AuthenticationRequiredState handled as well.
2. Psalm has a few errors, let's address them, and make sure that there are no left-over @throws in transition methods, especially within InitialState.
3. There are various unused use statements. Let's tidy up the code by removing them.

It might make sense to address as much as possible before starting to fix existing tests, and adding new ones, to avoid having to change fresh tests.

[RadoslavGeorgiev]

Only a couple of small (new) things I noticed. There are some comments from previous reviews that are not addressed, probably because they were collapsed:

[htdat]

Based on #7471 (comment):

Suggested change

	class AuthenticationRequiredState extends AbstractPaymentState {
	class PendingAuthenticationState extends AbstractPaymentState {

[RadoslavGeorgiev]

LGTM!

Thank you for bearing with me through all the nitpicks :)

[zmaglica]

LGTM!

Thank you for bearing with me through all the nitpicks :)

I love nitpicks 😃 Thank you for the extended review 🙇