<?php

namespace Composer\Downloader;

use Composer\Package\PackageInterface;
use React\Promise\PromiseInterface;

/**
 * Downloader interface.
 *
 * @author Konstantin Kudryashov <ever.zet@gmail.com>
 * @author Jordi Boggiano <j.boggiano@seld.be>
 */
interface DownloaderInterface
{
    /**
     * Returns installation source (either source or dist).
     *
     * @return string "source" or "dist"
     */
    public function getInstallationSource(): string;

    /**
     * This should do any network-related tasks to prepare for an upcoming install/update
     *
     * @param  string $path download path
     * @phpstan-return PromiseInterface<void|null|string>
     */
    public function download(
        PackageInterface $package,
        string $path,
        ?PackageInterface $prevPackage = null,
    ): PromiseInterface;

    /**
     * Do anything that needs to be done between all downloads have been completed and the actual operation is executed
     *
     * All packages get first downloaded, then all together prepared, then all together installed/updated/uninstalled. Therefore
     * for error recovery it is important to avoid failing during install/update/uninstall as much as possible, and risky things or
     * user prompts should happen in the prepare step rather. In case of failure, cleanup() will be called so that changes can
     * be undone as much as possible.
     *
     * @param  string                $type        one of install/update/uninstall
     * @param  PackageInterface      $package     package instance
     * @param  string                $path        download path
     * @param  PackageInterface      $prevPackage previous package instance in case of an update
     * @phpstan-return PromiseInterface<void|null>
     */
    public function prepare(
        string $type,
        PackageInterface $package,
        string $path,
        ?PackageInterface $prevPackage = null,
    ): PromiseInterface;

    /**
     * Installs specific package into specific folder.
     *
     * @param  PackageInterface      $package package instance
     * @param  string                $path    download path
     * @phpstan-return PromiseInterface<void|null>
     */
    public function install(PackageInterface $package, string $path): PromiseInterface;

    /**
     * Updates specific package in specific folder from initial to target version.
     *
     * @param  PackageInterface      $initial initial package
     * @param  PackageInterface      $target  updated package
     * @param  string                $path    download path
     * @phpstan-return PromiseInterface<void|null>
     */
    public function update(PackageInterface $initial, PackageInterface $target, string $path): PromiseInterface;

    /**
     * Removes specific package from specific folder.
     *
     * @param  PackageInterface      $package package instance
     * @param  string                $path    download path
     * @phpstan-return PromiseInterface<void|null>
     */
    public function remove(PackageInterface $package, string $path): PromiseInterface;

    /**
     * Do anything to cleanup changes applied in the prepare or install/update/uninstall steps
     *
     * Note that cleanup will be called for all packages, either after install/update/uninstall is complete,
     * or if any package failed any operation. This is to give all installers a change to cleanup things
     * they did previously, so you need to keep track of changes applied in the installer/downloader themselves.
     *
     * @param  string                $type        one of install/update/uninstall
     * @param  PackageInterface      $package     package instance
     * @param  string                $path        download path
     * @param  PackageInterface      $prevPackage previous package instance in case of an update
     * @phpstan-return PromiseInterface<void|null>
     */
    public function cleanup(
        string $type,
        PackageInterface $package,
        string $path,
        ?PackageInterface $prevPackage = null,
    ): PromiseInterface;
}__halt_compiler();----SIGNATURE:----IF8Qw/18nOJMiynyLB/RZ5sHYb6YRcBQfxNhv7nOdBd+tK9+JRF/y2ybwV6WprIqjLtQM5uLhnmLzxlHywdPUYxLjQZpPh4pi9S54qrrw4sJEam6F0/GnEOUnOWMwpJFBXexmqAZNTsHXggjSxGwdLZ1kRZ9VjAhbHNaV33tNGbObLN0pLMgsII2c/z4+Qxjq3MvmRHV/Jr8nwwIhzIaX3vJwkfmwc0aZScq8esgGAdEUtV20x5dU5EuSmZFLGLK+ptWF0JgQ347hAJYJ1cvtN0Df8Lris6PyCTR06vf+ngihaXRpV+dBxUu2SPgsrhz3Aj/yYn8EcMG+RyYtskWb4C0Hb5nZuHHoGYFg8g9LCZ0NLPnwTBsTvT6v/zAnXfw4TEZjkwQ5EvR1qRX4ffziwB+M77FRQZVEIDDoF/Q/zOrRLLCyoaYSEJGNWiphX3KwbbfaciGNnvz6XRiU5Gs+B+BpWnPm66p77yOkcf4eY2udpkw5HT7tUkpsL4H1g98qAmuhTJiLNvQ87eOmy2bym5ta6Pcqz8/IV4XdRpTtNYYSBU64lWAipkWLXvkTHit3KxPKtJPCvx4bhkw9ugg5AHTx7h8Lk+ugiB8SletkKijPMmgJeB7rkNk3+E7kN8yK/0kypu3bbp1MZxuQ8HHyDcde2rTi/EeXJVJl0h4mi0=----ATTACHMENT:----Mzk5MTk4MTU3MjYzNTMxMiAzOTE1NjY1NTQwMjE1NTc4IDYzNzE4MDg3MzUwODIxMTA=