feature symfony#59667 [Notifier] [Bluesky] Allow to attach website preview card (ppoulpe)

This PR was merged into the 7.3 branch.

Discussion
----------

[Notifier] [Bluesky] Allow to attach website preview card

| Q             | A
| ------------- | ---
| Branch?       | 7.3 <!-- see below -->
| 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

<!--
Replace this notice by a description of your feature/bugfix.
This will help reviewers and should be a good start for the documentation.

Additionally (see https://symfony.com/releases):
 - Always add tests and ensure they pass.
 - Bug fixes must be submitted against the lowest maintained branch where they apply
   (lowest branches are regularly merged to upper ones so they get the fixes too).
 - Features and deprecations must be submitted against the latest branch.
 - For new features, provide some code snippets to help understand usage.
 - Changelog entry should follow https://symfony.com/doc/current/contributing/code/conventions.html#writing-a-changelog-entry
 - Never break backward compatibility (see https://symfony.com/bc).
-->

This addition will allow us to add a preview card to a link:
![image](https://github.com/user-attachments/assets/c2d5a19c-95e1-4160-8677-8e5cb15af904)

Commits
-------

15ded98 [Notifier] [Bluesky] Allow to attach website preview card

Author: fabpot

src/Symfony/Component/Notifier/Bridge/Bluesky/BlueskyOptions.php

@@ -43,4 +43,16 @@ public function attachMedia(File $file, string $description = ''): static
 
         return $this;
     }
+
+    public function attachCard(string $uri, File $thumb, string $title = '', string $description = ''): static
+    {
+        $this->options['external'] = [
+            'uri' => $uri,
+            'thumb' => $thumb,
+            'title' => $title,
+            'description' => $description,
+        ];
+
+        return $this;
+    }
 }

src/Symfony/Component/Notifier/Bridge/Bluesky/BlueskyTransport.php

@@ -91,6 +91,26 @@ protected function doSend(MessageInterface $message): SentMessage
             unset($options['attach']);
         }
 
+        if (isset($options['external'])) {
+            $uploadedMedia = $this->uploadMedia([
+                [
+                    'file' => $options['external']['thumb'],
+                    'description' => $options['external']['description'],
+                ],
+            ]);
+
+            $options['record']['embed'] = [
+                '$type' => 'app.bsky.embed.external',
+                'external' => [
+                    'uri' => $options['external']['uri'],
+                    'title' => $options['external']['title'],
+                    'description' => $options['external']['description'],
+                    'thumb' => $uploadedMedia[array_key_first($uploadedMedia)]['image'],
+                ],
+            ];
+            unset($options['external']);
+        }
+
         $response = $this->client->request('POST', \sprintf('https://%s/xrpc/com.atproto.repo.createRecord', $this->getEndpoint()), [
             'auth_bearer' => $this->authSession['accessJwt'] ?? null,
             'json' => $options,

src/Symfony/Component/Notifier/Bridge/Bluesky/CHANGELOG.md

@@ -1,6 +1,11 @@
 CHANGELOG
 =========
 
+7.3
+---
+
+ * Add option to attach a website preview card
+
 7.2
 ---
 

src/Symfony/Component/Notifier/Bridge/Bluesky/README.md

@@ -10,6 +10,30 @@ DSN example
 BLUESKY_DSN=bluesky://nyholm.bsky.social:[email protected]
 ```
 
+Adding Options to a Message
+---------------------------
+
+Use a `BlueskyOptions` object to add options to the message:
+
+```php
+use Symfony\Component\Notifier\Bridge\Bluesky\BlueskyOptions;
+use Symfony\Component\Notifier\Message\ChatMessage;
+
+$message = new ChatMessage('My message');
+
+// Add website preview card to the message
+$options = (new BlueskyOptions())
+    ->attachCard('https://example.com', new File('image.jpg'))
+    // You can also add media to the message
+    //->attachMedia(new File($command->fileName), 'description')
+    ;
+
+// Add the custom options to the Bluesky message and send the message
+$message->options($options);
+
+$chatter->send($message);
+```
+
 Resources
 ---------
 

src/Symfony/Component/Notifier/Bridge/Bluesky/Tests/BlueskyTransportTest.php

@@ -274,9 +274,12 @@ public function testParseFacetsUrlWithTrickyRegex()
         $this->assertEquals($expected, $this->parseFacets($input));
     }
 
-    public function testWithMedia()
+    /**
+     * @dataProvider sendMessageWithEmbedDataProvider
+     */
+    public function testWithEmbed(BlueskyOptions $blueskyOptions, string $expectedJsonResponse)
     {
-        $transport = $this->createTransport(new MockHttpClient((function () {
+        $transport = $this->createTransport(new MockHttpClient((function () use ($expectedJsonResponse) {
             yield function (string $method, string $url, array $options) {
                 $this->assertSame('POST', $method);
                 $this->assertSame('https://bsky.social/xrpc/com.atproto.server.createSession', $url);
@@ -299,23 +302,49 @@ public function testWithMedia()
                 ]]);
             };
 
-            yield function (string $method, string $url, array $options) {
+            yield function (string $method, string $url, array $options) use ($expectedJsonResponse) {
                 $this->assertSame('POST', $method);
                 $this->assertSame('https://bsky.social/xrpc/com.atproto.repo.createRecord', $url);
                 $this->assertArrayHasKey('authorization', $options['normalized_headers']);
-                $this->assertSame('{"repo":null,"collection":"app.bsky.feed.post","record":{"$type":"app.bsky.feed.post","text":"Hello World!","createdAt":"2024-04-28T08:40:17.000000Z","embed":{"$type":"app.bsky.embed.images","images":[{"alt":"A fixture","image":{"$type":"blob","ref":{"$link":"bafkreibabalobzn6cd366ukcsjycp4yymjymgfxcv6xczmlgpemzkz3cfa"},"mimeType":"image\/png","size":760898}}]}}}', $options['body']);
+                $this->assertSame($expectedJsonResponse, $options['body']);
 
                 return new JsonMockResponse(['cid' => '103254962155278888']);
             };
         })()));
 
-        $options = (new BlueskyOptions())
-            ->attachMedia(new File(__DIR__.'/fixtures.gif'), 'A fixture');
-        $result = $transport->send(new ChatMessage('Hello World!', $options));
+        $result = $transport->send(new ChatMessage('Hello World!', $blueskyOptions));
 
         $this->assertSame('103254962155278888', $result->getMessageId());
     }
 
+    public function sendMessageWithEmbedDataProvider(): iterable
+    {
+        yield 'With media' => [
+            'options' => (new BlueskyOptions())->attachMedia(new File(__DIR__.'/fixtures.gif'), 'A fixture'),
+            'expectedResponse' => '{"repo":null,"collection":"app.bsky.feed.post","record":{"$type":"app.bsky.feed.post","text":"Hello World!","createdAt":"2024-04-28T08:40:17.000000Z","embed":{"$type":"app.bsky.embed.images","images":[{"alt":"A fixture","image":{"$type":"blob","ref":{"$link":"bafkreibabalobzn6cd366ukcsjycp4yymjymgfxcv6xczmlgpemzkz3cfa"},"mimeType":"image\/png","size":760898}}]}}}',
+        ];
+
+        yield 'With website preview card and all optionnal informations' => [
+            'options' => (new BlueskyOptions())
+                ->attachCard(
+                    'https://example.com',
+                    new File(__DIR__.'/fixtures.gif'),
+                    'Fork me im famous',
+                    'Click here to go to website!'
+                ),
+            'expectedResponse' => '{"repo":null,"collection":"app.bsky.feed.post","record":{"$type":"app.bsky.feed.post","text":"Hello World!","createdAt":"2024-04-28T08:40:17.000000Z","embed":{"$type":"app.bsky.embed.external","external":{"uri":"https:\/\/example.com","title":"Fork me im famous","description":"Click here to go to website!","thumb":{"$type":"blob","ref":{"$link":"bafkreibabalobzn6cd366ukcsjycp4yymjymgfxcv6xczmlgpemzkz3cfa"},"mimeType":"image\/png","size":760898}}}}}',
+        ];
+
+        yield 'With website preview card and minimal information' => [
+            'options' => (new BlueskyOptions())
+                ->attachCard(
+                    'https://example.com',
+                    new File(__DIR__.'/fixtures.gif')
+                ),
+            'expectedResponse' => '{"repo":null,"collection":"app.bsky.feed.post","record":{"$type":"app.bsky.feed.post","text":"Hello World!","createdAt":"2024-04-28T08:40:17.000000Z","embed":{"$type":"app.bsky.embed.external","external":{"uri":"https:\/\/example.com","title":"","description":"","thumb":{"$type":"blob","ref":{"$link":"bafkreibabalobzn6cd366ukcsjycp4yymjymgfxcv6xczmlgpemzkz3cfa"},"mimeType":"image\/png","size":760898}}}}}',
+        ];
+    }
+
     /**
      * A small helper function to test BlueskyTransport::parseFacets().
      */