laudis-technologies/neo4j-php-client

<?php

declare(strict_types=1);

/*
 * This file is part of the Neo4j PHP Client and Driver package.
 *
 * (c) Nagels <https://nagels.tech>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 */

namespace Laudis\Neo4j\Http;

use Laudis\Neo4j\Common\ConnectionConfiguration;
use Laudis\Neo4j\Contracts\AuthenticateInterface;
use Laudis\Neo4j\Contracts\ConnectionInterface;
use Laudis\Neo4j\Databags\DatabaseInfo;
use Laudis\Neo4j\Enum\AccessMode;
use Laudis\Neo4j\Enum\ConnectionProtocol;
use Psr\Http\Client\ClientInterface;
use Psr\Http\Message\UriInterface;

/**
 * @implements ConnectionInterface<ClientInterface>
 */
final class HttpConnection implements ConnectionInterface
{
    private bool $isOpen = true;

    /**
     * @psalm-mutation-free
     */
    public function __construct(
        /** @psalm-readonly */
        private readonly ClientInterface $client,
        /** @psalm-readonly */
        private readonly ConnectionConfiguration $config,
        private readonly AuthenticateInterface $authenticate,
        private readonly string $userAgent
    ) {}

    /**
     * @psalm-mutation-free
     */
    public function getImplementation(): ClientInterface
    {
        return $this->client;
    }

    /**
     * @psalm-mutation-free
     */
    public function getServerAgent(): string
    {
        return $this->config->getServerAgent();
    }

    /**
     * @psalm-mutation-free
     */
    public function getServerAddress(): UriInterface
    {
        return $this->config->getServerAddress();
    }

    /**
     * @psalm-mutation-free
     */
    public function getServerVersion(): string
    {
        return $this->config->getServerVersion();
    }

    /**
     * @psalm-mutation-free
     */
    public function getProtocol(): ConnectionProtocol
    {
        return $this->config->getProtocol();
    }

    /**
     * @psalm-mutation-free
     */
    public function getAccessMode(): AccessMode
    {
        return $this->config->getAccessMode();
    }

    /**
     * @psalm-mutation-free
     */
    public function getDatabaseInfo(): DatabaseInfo
    {
        return $this->config->getDatabaseInfo() ?? new DatabaseInfo('');
    }

    /**
     * @psalm-mutation-free
     */
    public function isOpen(): bool
    {
        return $this->isOpen;
    }

    /**
     * @psalm-external-mutation-free
     */
    public function open(): void
    {
        $this->isOpen = true;
    }

    /**
     * @psalm-external-mutation-free
     */
    public function close(): void
    {
        $this->isOpen = false;
    }

    public function reset(): void
    {
        // Cannot reset a stateless protocol
    }

    public function setTimeout(float $timeout): void
    {
        // Impossible to actually set a timeout with PSR definition
    }

    /**
     * @psalm-immutable
     */
    public function getAuthentication(): AuthenticateInterface
    {
        return $this->authenticate;
    }

    /**
     * @psalm-mutation-free
     */
    public function getServerState(): string
    {
        return 'UNKNOWN';
    }

    /**
     * @psalm-mutation-free
     */
    public function getEncryptionLevel(): string
    {
        return $this->config->getEncryptionLevel();
    }

    /**
     * @psalm-mutation-free
     */
    public function getUserAgent(): string
    {
        return $this->userAgent;
    }
}