feature symfony#59612 [Mailer] Add attachments support for Sweego Mailer Bridge (welcoMattic)

This PR was merged into the 7.3 branch.

Discussion
----------

[Mailer] Add attachments support for Sweego Mailer Bridge

| Q             | A
| ------------- | ---
| Branch?       | 7.3
| Bug fix?      | no
| New feature?  | yes<!-- please update src/**/CHANGELOG.md files -->
| Deprecations? | no <!-- please update UPGRADE-*.md and src/**/CHANGELOG.md files -->
| Issues        | Fix #... <!-- prefix each issue number with "Fix #", no need to create an issue if none exists, explain below instead -->
| License       | MIT

Sweego has added support for attachments on their API. This PR include it in the Bridge.
I tested it in a real application with .txt, .pdf and .png files. Mails are delivered with attachments.

As no other Bridge has tests for attachments AFAIK, I didn't write them. It could be part of a dedicated PR.

Commits
-------

b5b76fc feat(sweego): Add attachments support for Sweego Mailer Bridge

Author: fabpot

src/Symfony/Component/Mailer/Bridge/Sweego/CHANGELOG.md

@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+7.3
+---
+
+ * Add support for attachments
+
 7.2
 ---
 

src/Symfony/Component/Mailer/Bridge/Sweego/README.md

@@ -24,6 +24,30 @@ MAILER_DSN=sweego+api://API_KEY@default
 where:
  - `API_KEY` is your Sweego API Key
 
+Features
+--------
+
+### Attachments
+
+The bridge supports both regular attachments and inline attachments (for embedding images in HTML emails):
+
+```php
+use Symfony\Component\Mime\Email;
+
+$email = new Email();
+$email
+    ->to('[email protected]')
+    ->from('[email protected]')
+    ->subject('Email with attachments')
+    ->text('Here is the text version')
+    ->html('<p>Here is the HTML content</p>')
+    // Regular attachment
+    ->attach('Hello world!', 'test.txt', 'text/plain')
+    // Inline attachment (embedded image)
+    ->embed(fopen('image.jpg', 'r'), 'image.jpg', 'image/jpeg')
+;
+```
+
 Webhook
 -------
 

src/Symfony/Component/Mailer/Bridge/Sweego/Transport/SweegoApiTransport.php

@@ -100,6 +100,10 @@ private function getPayload(Email $email, Envelope $envelope): array
             $payload['message-html'] = $email->getHtmlBody();
         }
 
+        if ($email->getAttachments()) {
+            $payload['attachments'] = $this->getAttachments($email);
+        }
+
         if ($payload['headers'] = $this->prepareHeaders($email->getHeaders())) {
             if (\count($payload['headers']) > 5) {
                 throw new InvalidArgumentException('Sweego API supports up to 5 headers.');
@@ -111,6 +115,30 @@ private function getPayload(Email $email, Envelope $envelope): array
         return $payload;
     }
 
+    private function getAttachments(Email $email): array
+    {
+        $attachments = [];
+        foreach ($email->getAttachments() as $attachment) {
+            $headers = $attachment->getPreparedHeaders();
+            $filename = $headers->getHeaderParameter('Content-Disposition', 'filename');
+            $disposition = $headers->getHeaderBody('Content-Disposition');
+
+            $att = [
+                'content' => $attachment->bodyToString(),
+                'filename' => $filename,
+                'disposition' => $disposition,
+            ];
+
+            if ('inline' === $disposition) {
+                $att['content_id'] = $attachment->hasContentId() ? $attachment->getContentId() : $filename;
+            }
+
+            $attachments[] = $att;
+        }
+
+        return $attachments;
+    }
+
     private function prepareHeaders(Headers $headers): array
     {
         $headersPrepared = [];