feature #58698 [Mailer] Add AhaSend Bridge (farhadhf)

This PR was squashed before being merged into the 7.3 branch.

Discussion
----------

[Mailer] Add AhaSend Bridge

| Q             | A
| ------------- | ---
| Branch?       | 7.3
| Bug fix?      | no
| New feature?  | yes
| Deprecations? | no
| Issues        |
| License       | MIT
| Doc PR | symfony/symfony-docs#20361
| Recipe PR | symfony/recipes#1350

This PR adds support for a new mail bridge for the [AhaSend](https://ahasend.com) email service.
It includes support for SMTP and API transports (along with support for attachments for the API transport), and both delivery and engagement webhooks.

Commits
-------

3dfad14c714 [Mailer] Add AhaSend Bridge

Exception/UnsupportedSchemeException.php

@@ -20,6 +20,10 @@
 class UnsupportedSchemeException extends LogicException
 {
     private const SCHEME_TO_PACKAGE_MAP = [
+        'ahasend' => [
+            'class' => Bridge\AhaSend\Transport\AhaSendTransportFactory::class,
+            'package' => 'symfony/ahasend-mailer',
+        ],
         'azure' => [
             'class' => Bridge\Azure\Transport\AzureTransportFactory::class,
             'package' => 'symfony/azure-mailer',

Tests/Exception/UnsupportedSchemeExceptionTest.php

@@ -13,6 +13,7 @@
 
 use PHPUnit\Framework\TestCase;
 use Symfony\Bridge\PhpUnit\ClassExistsMock;
+use Symfony\Component\Mailer\Bridge\AhaSend\Transport\AhaSendTransportFactory;
 use Symfony\Component\Mailer\Bridge\Amazon\Transport\SesTransportFactory;
 use Symfony\Component\Mailer\Bridge\Azure\Transport\AzureTransportFactory;
 use Symfony\Component\Mailer\Bridge\Brevo\Transport\BrevoTransportFactory;
@@ -43,6 +44,7 @@ public static function setUpBeforeClass(): void
     {
         ClassExistsMock::register(__CLASS__);
         ClassExistsMock::withMockedClasses([
+            AhaSendTransportFactory::class => false,
             AzureTransportFactory::class => false,
             BrevoTransportFactory::class => false,
             GmailTransportFactory::class => false,
@@ -79,6 +81,7 @@ public function testMessageWhereSchemeIsPartOfSchemeToPackageMap(string $scheme,
 
     public static function messageWhereSchemeIsPartOfSchemeToPackageMapProvider(): \Generator
     {
+        yield ['ahasend', 'symfony/ahasend-mailer'];
         yield ['azure', 'symfony/azure-mailer'];
         yield ['brevo', 'symfony/brevo-mailer'];
         yield ['gmail', 'symfony/google-mailer'];

Transport.php

@@ -13,6 +13,7 @@
 
 use Psr\EventDispatcher\EventDispatcherInterface;
 use Psr\Log\LoggerInterface;
+use Symfony\Component\Mailer\Bridge\AhaSend\Transport\AhaSendTransportFactory;
 use Symfony\Component\Mailer\Bridge\Amazon\Transport\SesTransportFactory;
 use Symfony\Component\Mailer\Bridge\Azure\Transport\AzureTransportFactory;
 use Symfony\Component\Mailer\Bridge\Brevo\Transport\BrevoTransportFactory;
@@ -52,6 +53,7 @@
 final class Transport
 {
     private const FACTORY_CLASSES = [
+        AhaSendTransportFactory::class,
         AzureTransportFactory::class,
         BrevoTransportFactory::class,
         GmailTransportFactory::class,