. */ declare(strict_types=1); namespace Akeeba\WebPush\WebPush; /** * This class is a derivative work based on the WebPush library by Louis Lagrange. It has been modified to only use * dependencies shipped with Joomla itself and must not be confused with the original work. * * You can find the original code at https://github.com/web-push-libs * * The original code came with the following copyright notice: * * ===================================================================================================================== * * This file is part of the WebPush library. * * (c) Louis Lagrange * * For the full copyright and license information, please view the LICENSE-LAGRANGE.txt * file that was distributed with this source code. * * ===================================================================================================================== */ class Subscription implements SubscriptionInterface { /** @var null|string */ private $authToken; /** @var null|string */ private $contentEncoding; /** @var string */ private $endpoint; /** @var null|string */ private $publicKey; /** * @param string|null $contentEncoding (Optional) Must be "aesgcm" * * @throws \ErrorException */ public function __construct( string $endpoint, ?string $publicKey = null, ?string $authToken = null, ?string $contentEncoding = null ) { $this->endpoint = $endpoint; if ($publicKey || $authToken || $contentEncoding) { $supportedContentEncodings = ['aesgcm', 'aes128gcm']; if ($contentEncoding && !in_array($contentEncoding, $supportedContentEncodings)) { throw new \ErrorException('This content encoding (' . $contentEncoding . ') is not supported.'); } $this->publicKey = $publicKey; $this->authToken = $authToken; $this->contentEncoding = $contentEncoding ?: "aesgcm"; } } /** * @param array $associativeArray (with keys endpoint, publicKey, authToken, contentEncoding) * * @throws \ErrorException */ public static function create(array $associativeArray): self { if (array_key_exists('keys', $associativeArray) && is_array($associativeArray['keys'])) { return new self( $associativeArray['endpoint'], $associativeArray['keys']['p256dh'] ?? null, $associativeArray['keys']['auth'] ?? null, $associativeArray['contentEncoding'] ?? "aesgcm" ); } if (array_key_exists('publicKey', $associativeArray) || array_key_exists('authToken', $associativeArray) || array_key_exists('contentEncoding', $associativeArray)) { return new self( $associativeArray['endpoint'], $associativeArray['publicKey'] ?? null, $associativeArray['authToken'] ?? null, $associativeArray['contentEncoding'] ?? "aesgcm" ); } return new self( $associativeArray['endpoint'] ); } /** * {@inheritDoc} */ public function getAuthToken(): ?string { return $this->authToken; } /** * {@inheritDoc} */ public function getContentEncoding(): ?string { return $this->contentEncoding; } /** * {@inheritDoc} */ public function getEndpoint(): string { return $this->endpoint; } /** * {@inheritDoc} */ public function getPublicKey(): ?string { return $this->publicKey; } }