feat(token-extractor): introduce token extractor component

.github/workflows/split-monorepo.yaml

@@ -95,6 +95,8 @@ jobs:
             split_repository: 'event'
           - local_path:       'Component/Ddd'
             split_repository: 'ddd'
+          - local_path:       'Component/TokenExtractor'
+            split_repository: 'token-extractor'
 
           # Contracts
           - local_path:       'Contracts/Config'
@@ -121,6 +123,8 @@ jobs:
             split_repository: 'event-contracts'
           - local_path:       'Contracts/Ddd'
             split_repository: 'ddd-contracts'
+          - local_path:       'Contracts/TokenExtractor'
+            split_repository: 'token-extractor-contracts'
 
           # Annotations
           - local_path:       'Annotations/Eloquent'

src/Component/TokenExtractor/BearerTokenExtractor.php

@@ -0,0 +1,29 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pandawa\Component\TokenExtractor;
+
+use Pandawa\Contracts\TokenExtractor\TokenExtractorInterface;
+use Psr\Http\Message\ServerRequestInterface;
+
+/**
+ * @author  Iqbal Maulana <iq.bluejack@gmail.com>
+ */
+final class BearerTokenExtractor implements TokenExtractorInterface
+{
+    public function extract(ServerRequestInterface $request): ?string
+    {
+        $header = $request->getHeaderLine('Authorization');
+
+        $position = strrpos($header, 'Bearer ');
+
+        if (false !== $position) {
+            $header = substr($header, $position + 7);
+
+            return str_contains($header, ',') ? strstr($header, ',', true) : $header;
+        }
+
+        return null;
+    }
+}

src/Component/TokenExtractor/ChainTokenExtractor.php

@@ -0,0 +1,38 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pandawa\Component\TokenExtractor;
+
+use Pandawa\Contracts\TokenExtractor\TokenExtractorInterface;
+use Psr\Http\Message\ServerRequestInterface;
+
+/**
+ * @author  Iqbal Maulana <iq.bluejack@gmail.com>
+ */
+final class ChainTokenExtractor implements TokenExtractorInterface
+{
+    /**
+     * @var TokenExtractorInterface[]
+     */
+    private array $tokenExtractors;
+
+    public function __construct()
+    {
+        $this->tokenExtractors = [
+            new BearerTokenExtractor(),
+            new QueryParamTokenExtractor(),
+        ];
+    }
+
+    public function extract(ServerRequestInterface $request): ?string
+    {
+        foreach ($this->tokenExtractors as $tokenExtractor) {
+            if (null !== $token = $tokenExtractor->extract($request)) {
+                return $token;
+            }
+        }
+
+        return null;
+    }
+}

src/Component/TokenExtractor/QueryParamTokenExtractor.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pandawa\Component\TokenExtractor;
+
+use Pandawa\Contracts\TokenExtractor\TokenExtractorInterface;
+use Psr\Http\Message\ServerRequestInterface;
+
+/**
+ * @author  Iqbal Maulana <iq.bluejack@gmail.com>
+ */
+final class QueryParamTokenExtractor implements TokenExtractorInterface
+{
+    public static string $PARAM = '_token';
+
+    public function extract(ServerRequestInterface $request): ?string
+    {
+        return $request->getQueryParams()[self::$PARAM] ?? null;
+    }
+}

src/Component/TokenExtractor/composer.json

@@ -0,0 +1,29 @@
+{
+    "name": "pandawa/token-extractor",
+    "description": "The pandawa token extractor component",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Iqbal Maulana",
+            "email": "iq.bluejack@gmail.com"
+        }
+    ],
+    "require": {
+        "php": ">=8.1",
+        "pandawa/token-extractor-contracts": "^5.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Pandawa\\Component\\TokenExtractor\\": ""
+        }
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "5.x-dev"
+        }
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "minimum-stability": "dev"
+}

src/Contracts/TokenExtractor/TokenExtractorInterface.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Pandawa\Contracts\TokenExtractor;
+
+use Psr\Http\Message\ServerRequestInterface;
+
+/**
+ * @author  Iqbal Maulana <iq.bluejack@gmail.com>
+ */
+interface TokenExtractorInterface
+{
+    public function extract(ServerRequestInterface $request): ?string;
+}

src/Contracts/TokenExtractor/composer.json

@@ -0,0 +1,28 @@
+{
+    "name": "pandawa/token-extractor-contracts",
+    "description": "The pandawa token extractor contracts",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Iqbal Maulana",
+            "email": "iq.bluejack@gmail.com"
+        }
+    ],
+    "require": {
+        "php": ">=8.1"
+    },
+    "autoload": {
+        "psr-4": {
+            "Pandawa\\Contracts\\TokenExtractor\\": ""
+        }
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "5.x-dev"
+        }
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "minimum-stability": "dev"
+}