Http: Rename/duplicate credential class files before refactoring

Author: lkrms

src/Toolkit/Http/OAuth2/AccessToken.php renamed to src/Toolkit/Http/GenericToken.php

@@ -0,0 +1,82 @@
+<?php declare(strict_types=1);
+
+namespace Salient\Http\OAuth2;
+
+use Salient\Contract\Core\Entity\Readable;
+use Salient\Contract\Core\Immutable;
+use Salient\Contract\Http\CredentialInterface;
+use Salient\Core\Concern\ReadableProtectedPropertiesTrait;
+use Salient\Utility\Date;
+use DateTimeImmutable;
+use DateTimeInterface;
+use InvalidArgumentException;
+
+/**
+ * A token issued by an authorization provider for access to protected resources
+ *
+ * @property-read string $Token
+ * @property-read string $Type
+ * @property-read DateTimeImmutable|null $Expires
+ * @property-read string[] $Scopes
+ * @property-read array<string,mixed> $Claims
+ */
+final class AccessToken implements CredentialInterface, Immutable, Readable
+{
+    use ReadableProtectedPropertiesTrait;
+
+    protected string $Token;
+    protected string $Type;
+    protected ?DateTimeImmutable $Expires;
+    /** @var string[] */
+    protected array $Scopes;
+    /** @var array<string,mixed> */
+    protected array $Claims;
+
+    /**
+     * @param DateTimeInterface|int|null $expires `null` if the access token's
+     * lifetime is unknown, otherwise a {@see DateTimeInterface} or Unix
+     * timestamp representing its expiration time.
+     * @param string[]|null $scopes
+     * @param array<string,mixed>|null $claims
+     */
+    public function __construct(
+        string $token,
+        string $type,
+        $expires,
+        ?array $scopes = null,
+        ?array $claims = null
+    ) {
+        if (is_int($expires) && $expires < 0) {
+            throw new InvalidArgumentException(sprintf(
+                'Invalid $expires: %d',
+                $expires
+            ));
+        }
+
+        $this->Token = $token;
+        $this->Type = $type;
+        $this->Expires = $expires instanceof DateTimeInterface
+            ? Date::immutable($expires)
+            : ($expires === null
+                ? null
+                : new DateTimeImmutable("@$expires"));
+        $this->Scopes = $scopes ?: [];
+        $this->Claims = $claims ?: [];
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getAuthenticationScheme(): string
+    {
+        return $this->Type;
+    }
+
+    /**
+     * @inheritDoc
+     */
+    public function getCredential(): string
+    {
+        return $this->Token;
+    }
+}