Twitter detector with API v2

Author: patriksh

src/Adapters/Twitter/Api.php

@@ -0,0 +1,36 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter;
+
+use function Embed\getDirectory;
+use Embed\HttpApiTrait;
+
+class Api
+{
+    use HttpApiTrait;
+
+    protected function fetchData(): array
+    {
+        $token = $this->extractor->getSetting('twitter:token');
+
+        if (!$token) {
+            return null;
+        }
+        
+        $uri = $this->extractor->getUri();
+
+        $id = getDirectory($uri->getPath(), 2);
+
+        if (empty($id)) {
+            return [];
+        }
+
+        $this->extractor->getCrawler()->addDefaultHeaders(array('Authorization' => "Bearer $token"));
+        $this->endpoint = $this->extractor->getCrawler()->createUri("https://api.twitter.com/2/tweets/{$id}?expansions=author_id,attachments.media_keys&tweet.fields=created_at&media.fields=preview_image_url&user.fields=id,name");
+
+        $data = $this->fetchJSON($this->endpoint);
+
+        return $data ?? [];
+    }
+}

src/Adapters/Twitter/Detectors/AuthorName.php

@@ -0,0 +1,17 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter\Detectors;
+
+use Embed\Detectors\AuthorName as Detector;
+
+class AuthorName extends Detector
+{
+    public function detect(): ?string
+    {
+        $api = $this->extractor->getApi();
+        
+        return $api->str('includes', 'users', '0', 'name')
+            ?: parent::detect();
+    }
+}

src/Adapters/Twitter/Detectors/AuthorUrl.php

@@ -0,0 +1,22 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter\Detectors;
+
+use Embed\Detectors\AuthorUrl as Detector;
+use Psr\Http\Message\UriInterface;
+
+class AuthorUrl extends Detector
+{
+    public function detect(): ?UriInterface
+    {
+        $api = $this->extractor->getApi();
+        $username = $api->str('includes', 'users', '0', 'username');
+
+        if ($username) {
+            return $this->extractor->getCrawler()->createUri("https://twitter.com/{$username}");
+        }
+
+        return parent::detect();
+    }
+}

src/Adapters/Twitter/Detectors/Description.php

@@ -0,0 +1,17 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter\Detectors;
+
+use Embed\Detectors\Description as Detector;
+
+class Description extends Detector
+{
+    public function detect(): ?string
+    {
+        $api = $this->extractor->getApi();
+
+        return $api->str('data', 'text')
+            ?: parent::detect();
+    }
+}

src/Adapters/Twitter/Detectors/Image.php

@@ -0,0 +1,18 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter\Detectors;
+
+use Embed\Detectors\Image as Detector;
+use Psr\Http\Message\UriInterface;
+
+class Image extends Detector
+{
+    public function detect(): ?UriInterface
+    {
+        $api = $this->extractor->getApi();
+
+        return $api->url('includes', 'media', '0', 'preview_image_url')
+            ?: parent::detect();
+    }
+}

src/Adapters/Twitter/Detectors/ProviderName.php

@@ -0,0 +1,14 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter\Detectors;
+
+use Embed\Detectors\ProviderName as Detector;
+
+class ProviderName extends Detector
+{
+    public function detect(): string
+    {
+        return 'Twitter';
+    }
+}

src/Adapters/Twitter/Detectors/PublishedTime.php

@@ -0,0 +1,18 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter\Detectors;
+
+use Datetime;
+use Embed\Detectors\PublishedTime as Detector;
+
+class PublishedTime extends Detector
+{
+    public function detect(): ?Datetime
+    {
+        $api = $this->extractor->getApi();
+
+        return $api->time('data', 'created_at')
+            ?: parent::detect();
+    }
+}

src/Adapters/Twitter/Detectors/Title.php

@@ -0,0 +1,21 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter\Detectors;
+
+use Embed\Detectors\Title as Detector;
+
+class Title extends Detector
+{
+    public function detect(): ?string
+    {
+        $api = $this->extractor->getApi();
+        $name = $api->str('includes', 'users', '0', 'name');
+
+        if ($name) {
+            return "Tweet by $name";
+        }
+
+        return parent::detect();
+    }
+}

src/Adapters/Twitter/Extractor.php

@@ -0,0 +1,31 @@
+<?php
+declare(strict_types = 1);
+
+namespace Embed\Adapters\Twitter;
+
+use Embed\Extractor as Base;
+
+class Extractor extends Base
+{
+    private Api $api;
+
+    public function getApi(): Api
+    {
+        return $this->api;
+    }
+
+    public function createCustomDetectors(): array
+    {
+        $this->api = new Api($this);
+
+        return [
+            'authorName' => new Detectors\AuthorName($this),
+            'authorUrl' => new Detectors\AuthorUrl($this),
+            'description' => new Detectors\Description($this),
+            'image' => new Detectors\Image($this),
+            'providerName' => new Detectors\ProviderName($this),
+            'publishedTime' => new Detectors\PublishedTime($this),
+            'title' => new Detectors\Title($this),
+        ];
+    }
+}

src/ExtractorFactory.php

@@ -29,6 +29,7 @@ class ExtractorFactory
         'youtube.com' => Adapters\Youtube\Extractor::class,
         'twitch.tv' => Adapters\Twitch\Extractor::class,
         'bandcamp.com' => Adapters\Bandcamp\Extractor::class,
+        'twitter.com' => Adapters\Twitter\Extractor::class,
     ];
     private array $customDetectors = [];
     private array $settings;