<?php

declare(strict_types=1);

/**
 * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */

namespace KTXF\Resource\Provider;

/**
 * Resource Service Location Uri
 * 
 * URI-based service location for API and web services (e.g., https://api.example.com:443/v1/endpoint).
 * 
 * @since 2025.05.01
 */
interface ResourceServiceLocationUri extends ResourceServiceLocationInterface {

    /**
     * Gets the complete location URI
     * 
     * @since 2025.05.01
     * 
     * @return string Complete URI (e.g., "https://api.example.com:443/v1")
     */
    public function location(): string;

    /**
     * Gets the URI scheme
     * 
     * @since 2025.05.01
     * 
     * @return string Scheme (e.g., "https", "http")
     */
    public function getScheme(): string;

    /**
     * Sets the URI scheme
     * 
     * @since 2025.05.01
     * 
     * @param string $value
     * 
     * @return void
     */
    public function setScheme(string $value): void;

    /**
     * Gets the host
     * 
     * @since 2025.05.01
     * 
     * @return string Host (e.g., "api.example.com")
     */
    public function getHost(): string;

    /**
     * Sets the host
     * 
     * @since 2025.05.01
     * 
     * @param string $value
     * 
     * @return void
     */
    public function setHost(string $value): void;

    /**
     * Gets the port
     * 
     * @since 2025.05.01
     * 
     * @return int Port number
     */
    public function getPort(): int;

    /**
     * Sets the port
     * 
     * @since 2025.05.01
     * 
     * @param int $value
     * 
     * @return void
     */
    public function setPort(int $value): void;

    /**
     * Gets the path
     * 
     * @since 2025.05.01
     * 
     * @return string Path (e.g., "/v1/api")
     */
    public function getPath(): string;

    /**
     * Sets the path
     * 
     * @since 2025.05.01
     * 
     * @param string $value
     * 
     * @return void
     */
    public function setPath(string $value): void;

    /**
     * Gets whether to verify SSL/TLS peer certificate
     * 
     * @since 2025.12.01
     * 
     * @return bool
     */
    public function getVerifyPeer(): bool;

    /**
     * Sets whether to verify SSL/TLS peer certificate
     * 
     * @since 2025.12.01
     * 
     * @param bool $value
     * 
     * @return void
     */
    public function setVerifyPeer(bool $value): void;

    /**
     * Gets whether to verify SSL/TLS certificate host
     * 
     * @since 2025.12.01
     * 
     * @return bool
     */
    public function getVerifyHost(): bool;

    /**
     * Sets whether to verify SSL/TLS certificate host
     * 
     * @since 2025.12.01
     * 
     * @param bool $value
     * 
     * @return void
     */
    public function setVerifyHost(bool $value): void;

}