<?php

/**
 * @package    Grav\Framework\Psr7
 *
 * @copyright  Copyright (c) 2015 - 2026 Trilby Media, LLC. All rights reserved.
 * @license    MIT License; see LICENSE file for details.
 */

namespace Grav\Framework\Psr7;

use Grav\Framework\Uri\UriPartsFilter;
use InvalidArgumentException;
use Psr\Http\Message\UriInterface;

/**
 * Bare minimum PSR7 implementation.
 *
 * @package Grav\Framework\Uri\Psr7
 * @deprecated 1.6 Using message PSR-7 decorators instead.
 */
abstract class AbstractUri implements UriInterface
{
    /** @var array */
    protected static $defaultPorts = [
        "http" => 80,
        "https" => 443,
    ];

    /** @var string Uri scheme. */
    private $scheme = "";
    /** @var string Uri user. */
    private $user = "";
    /** @var string Uri password. */
    private $password = "";
    /** @var string Uri host. */
    private $host = "";
    /** @var int|null Uri port. */
    private $port;
    /** @var string Uri path. */
    private $path = "";
    /** @var string Uri query string (without ?). */
    private $query = "";
    /** @var string Uri fragment (without #). */
    private $fragment = "";

    /**
     * Please define constructor which calls $this->init().
     */
    abstract public function __construct();

    /**
     * @inheritdoc
     */
    public function getScheme(): string
    {
        return $this->scheme;
    }

    /**
     * @inheritdoc
     */
    public function getAuthority(): string
    {
        $authority = $this->host;

        $userInfo = $this->getUserInfo();
        if ($userInfo !== "") {
            $authority = $userInfo . "@" . $authority;
        }

        if ($this->port !== null) {
            $authority .= ":" . $this->port;
        }

        return $authority;
    }

    /**
     * @inheritdoc
     */
    public function getUserInfo(): string
    {
        $userInfo = $this->user;

        if ($this->password !== "") {
            $userInfo .= ":" . $this->password;
        }

        return $userInfo;
    }

    /**
     * @inheritdoc
     */
    public function getHost(): string
    {
        return $this->host;
    }

    /**
     * @inheritdoc
     */
    public function getPort(): ?int
    {
        return $this->port;
    }

    /**
     * @inheritdoc
     */
    public function getPath(): string
    {
        return $this->path;
    }

    /**
     * @inheritdoc
     */
    public function getQuery(): string
    {
        return $this->query;
    }

    /**
     * @inheritdoc
     */
    public function getFragment(): string
    {
        return $this->fragment;
    }

    /**
     * @inheritdoc
     */
    public function withScheme(string $scheme): UriInterface
    {
        $scheme = UriPartsFilter::filterScheme($scheme);

        if ($this->scheme === $scheme) {
            return $this;
        }

        $new = clone $this;
        $new->scheme = $scheme;
        $new->unsetDefaultPort();
        $new->validate();

        return $new;
    }

    /**
     * @inheritdoc
     * @throws InvalidArgumentException
     */
    public function withUserInfo(string $user, ?string $password = null): UriInterface
    {
        $user = UriPartsFilter::filterUserInfo($user);
        $password = UriPartsFilter::filterUserInfo($password ?? "");

        if ($this->user === $user && $this->password === $password) {
            return $this;
        }

        $new = clone $this;
        $new->user = $user;
        $new->password = $user !== "" ? $password : "";
        $new->validate();

        return $new;
    }

    /**
     * @inheritdoc
     */
    public function withHost(string $host): UriInterface
    {
        $host = UriPartsFilter::filterHost($host);

        if ($this->host === $host) {
            return $this;
        }

        $new = clone $this;
        $new->host = $host;
        $new->validate();

        return $new;
    }

    /**
     * @inheritdoc
     */
    public function withPort(?int $port): UriInterface
    {
        $port = UriPartsFilter::filterPort($port);

        if ($this->port === $port) {
            return $this;
        }

        $new = clone $this;
        $new->port = $port;
        $new->unsetDefaultPort();
        $new->validate();

        return $new;
    }

    /**
     * @inheritdoc
     */
    public function withPath(string $path): UriInterface
    {
        $path = UriPartsFilter::filterPath($path);

        if ($this->path === $path) {
            return $this;
        }

        $new = clone $this;
        $new->path = $path;
        $new->validate();

        return $new;
    }

    /**
     * @inheritdoc
     */
    public function withQuery(string $query): UriInterface
    {
        $query = UriPartsFilter::filterQueryOrFragment($query);

        if ($this->query === $query) {
            return $this;
        }

        $new = clone $this;
        $new->query = $query;

        return $new;
    }

    /**
     * @inheritdoc
     * @throws InvalidArgumentException
     */
    public function withFragment(string $fragment): UriInterface
    {
        $fragment = UriPartsFilter::filterQueryOrFragment($fragment);

        if ($this->fragment === $fragment) {
            return $this;
        }

        $new = clone $this;
        $new->fragment = $fragment;

        return $new;
    }

    /**
     * @return string
     */
    #[\ReturnTypeWillChange]
    public function __toString(): string
    {
        return $this->getUrl();
    }

    /**
     * @return array
     */
    protected function getParts()
    {
        return [
            "scheme" => $this->scheme,
            "host" => $this->host,
            "port" => $this->port,
            "user" => $this->user,
            "pass" => $this->password,
            "path" => $this->path,
            "query" => $this->query,
            "fragment" => $this->fragment,
        ];
    }

    /**
     * Return the fully qualified base URL ( like http://getgrav.org ).
     *
     * Note that this method never includes a trailing /
     *
     * @return string
     */
    protected function getBaseUrl()
    {
        $uri = "";

        $scheme = $this->getScheme();
        if ($scheme !== "") {
            $uri .= $scheme . ":";
        }

        $authority = $this->getAuthority();
        if ($authority !== "" || $scheme === "file") {
            $uri .= "//" . $authority;
        }

        return $uri;
    }

    /**
     * @return string
     */
    protected function getUrl()
    {
        $uri = $this->getBaseUrl() . $this->getPath();

        $query = $this->getQuery();
        if ($query !== "") {
            $uri .= "?" . $query;
        }

        $fragment = $this->getFragment();
        if ($fragment !== "") {
            $uri .= "#" . $fragment;
        }

        return $uri;
    }

    /**
     * @return string
     */
    protected function getUser()
    {
        return $this->user;
    }

    /**
     * @return string
     */
    protected function getPassword()
    {
        return $this->password;
    }

    /**
     * @param array $parts
     * @return void
     * @throws InvalidArgumentException
     */
    protected function initParts(array $parts)
    {
        $this->scheme = isset($parts["scheme"])
            ? UriPartsFilter::filterScheme($parts["scheme"])
            : "";
        $this->user = isset($parts["user"])
            ? UriPartsFilter::filterUserInfo($parts["user"])
            : "";
        $this->password = isset($parts["pass"])
            ? UriPartsFilter::filterUserInfo($parts["pass"])
            : "";
        $this->host = isset($parts["host"])
            ? UriPartsFilter::filterHost($parts["host"])
            : "";
        $this->port = isset($parts["port"])
            ? UriPartsFilter::filterPort((int) $parts["port"])
            : null;
        $this->path = isset($parts["path"])
            ? UriPartsFilter::filterPath($parts["path"])
            : "";
        $this->query = isset($parts["query"])
            ? UriPartsFilter::filterQueryOrFragment($parts["query"])
            : "";
        $this->fragment = isset($parts["fragment"])
            ? UriPartsFilter::filterQueryOrFragment($parts["fragment"])
            : "";

        $this->unsetDefaultPort();
        $this->validate();
    }

    /**
     * @return void
     * @throws InvalidArgumentException
     */
    private function validate()
    {
        if (
            $this->host === "" &&
            ($this->scheme === "http" || $this->scheme === "https")
        ) {
            throw new InvalidArgumentException(
                "Uri with a scheme must have a host"
            );
        }

        if ($this->getAuthority() === "") {
            if (str_starts_with($this->path, "//")) {
                throw new InvalidArgumentException(
                    'The path of a URI without an authority must not start with two slashes \'//\''
                );
            }
            if (
                $this->scheme === "" &&
                str_contains(explode("/", $this->path, 2)[0], ":")
            ) {
                throw new InvalidArgumentException(
                    "A relative URI must not have a path beginning with a segment containing a colon"
                );
            }
        } elseif (isset($this->path[0]) && $this->path[0] !== "/") {
            throw new InvalidArgumentException(
                'The path of a URI with an authority must start with a slash \'/\' or be empty'
            );
        }
    }

    /**
     * @return bool
     */
    protected function isDefaultPort()
    {
        $scheme = $this->scheme;
        $port = $this->port;

        return $this->port === null ||
            (isset(static::$defaultPorts[$scheme]) &&
                $port === static::$defaultPorts[$scheme]);
    }

    /**
     * @return void
     */
    private function unsetDefaultPort()
    {
        if ($this->isDefaultPort()) {
            $this->port = null;
        }
    }
}