<?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 File
 * 
 * File-based service location for services using local or network file paths
 * (e.g., maildir, mbox, local storage).
 * 
 * @since 2025.05.01
 */
interface ResourceServiceLocationFile extends ResourceServiceLocationInterface {

    /**
     * Gets the complete file location path
     * 
     * @since 2025.05.01
     * 
     * @return string File path (e.g., "/var/mail/user" or "\\server\share\mail")
     */
    public function location(): string;

    /**
     * Gets the file location path
     * 
     * @since 2025.05.01
     * 
     * @return string File path
     */
    public function getLocation(): string;

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

}