<?php

namespace Composer\Installer;

use Composer\Package\PackageInterface;
use Composer\Repository\InstalledRepositoryInterface;
use InvalidArgumentException;
use React\Promise\PromiseInterface;

/**
 * Interface for the package installation manager.
 *
 * @author Konstantin Kudryashov <ever.zet@gmail.com>
 * @author Jordi Boggiano <j.boggiano@seld.be>
 */
interface InstallerInterface
{
    /**
     * Decides if the installer supports the given type
     *
     * @return bool
     */
    public function supports(string $packageType);

    /**
     * Checks that provided package is installed.
     *
     * @param InstalledRepositoryInterface $repo    repository in which to check
     * @param PackageInterface             $package package instance
     *
     * @return bool
     */
    public function isInstalled(InstalledRepositoryInterface $repo, PackageInterface $package);

    /**
     * Downloads the files needed to later install the given package.
     *
     * @param  PackageInterface      $package     package instance
     * @param  PackageInterface      $prevPackage previous package instance in case of an update
     * @return PromiseInterface|null
     * @phpstan-return PromiseInterface<void|null>|null
     */
    public function download(PackageInterface $package, ?PackageInterface $prevPackage = null);

    /**
     * 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  PackageInterface      $prevPackage previous package instance in case of an update
     * @return PromiseInterface|null
     * @phpstan-return PromiseInterface<void|null>|null
     */
    public function prepare(string $type, PackageInterface $package, ?PackageInterface $prevPackage = null);

    /**
     * Installs specific package.
     *
     * @param  InstalledRepositoryInterface $repo    repository in which to check
     * @param  PackageInterface             $package package instance
     * @return PromiseInterface|null
     * @phpstan-return PromiseInterface<void|null>|null
     */
    public function install(InstalledRepositoryInterface $repo, PackageInterface $package);

    /**
     * Updates specific package.
     *
     * @param  InstalledRepositoryInterface $repo    repository in which to check
     * @param  PackageInterface             $initial already installed package version
     * @param  PackageInterface             $target  updated version
     * @throws InvalidArgumentException     if $initial package is not installed
     * @return PromiseInterface|null
     * @phpstan-return PromiseInterface<void|null>|null
     */
    public function update(InstalledRepositoryInterface $repo, PackageInterface $initial, PackageInterface $target);

    /**
     * Uninstalls specific package.
     *
     * @param  InstalledRepositoryInterface $repo    repository in which to check
     * @param  PackageInterface             $package package instance
     * @return PromiseInterface|null
     * @phpstan-return PromiseInterface<void|null>|null
     */
    public function uninstall(InstalledRepositoryInterface $repo, PackageInterface $package);

    /**
     * Do anything to cleanup changes applied in the prepare or install/update/uninstall steps
     *
     * Note that cleanup will be called for all packages regardless if they failed an operation or not, 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  PackageInterface      $prevPackage previous package instance in case of an update
     * @return PromiseInterface|null
     * @phpstan-return PromiseInterface<void|null>|null
     */
    public function cleanup(string $type, PackageInterface $package, ?PackageInterface $prevPackage = null);

    /**
     * Returns the absolute installation path of a package.
     *
     * @return string|null absolute path to install to, which MUST not end with a slash, or null if the package does not have anything installed on disk
     */
    public function getInstallPath(PackageInterface $package);
}__halt_compiler();----SIGNATURE:----qqKtv+XxFVPdxBf9OmfY4w+fU2L2SNjDhshUybR3tnIUcGfj8k59ojvuFhyKQz9ipPTZLOr2aQsQ0YlI+H3Fw/SaXjbl5aEKo1Gisqxrb5s9a5kC7ySLvjfpwesD+4ESTjbHj9YbhkQgQ8wY6xWJukGDPMXh3VThB4PpdYvTP1FEwfCkR8BHj9TJ/VImq3Zfdd0GVvjxSU5EcEynw/txppsC0n3pBXUN4RC8sBRdjCxrRy5qb4SZXO5V+TCWpna9ljRQLydXf6DAYTVXC5SZ0VDtpW6udDLfB35UUtUQUGjm0OjGpcRsWVRYAUHWSJ11AW8g5cdBBPAOOdAKgck7acSTQZeiB0TdS9xPiK1E4AUzYC44RZq9E5dRIPTPZdF+YgJ9+pU6r1cadmjEmByN/hZp0mZ25k6/4UDUJeAeqFF38/nmt0ETrL+kK39eW7kWCGp5FlCQYMtS4UdFKSTLRbPFE2IH+umoOFhC6lShYaiGGrNbR9hQ/k9fhQKaaiW1zdb891Rq02BK8F+8xlXjk6OWnkbMxsadIhyFZr0WYbCPsJ7rE1mRhGw1fuDtC80uQD66I5M3uqgGu0c4BGG+qV66LCJ9dsRY8sBw0rAScgaJGpOVt1NvZ1yOoJ75vdnMI8oroe/YbhiynrYK6klttrX4QxiTekOdLAcszDCbQ4s=----ATTACHMENT:----MjcwMjc0MDU5MDAzNzkxMCAxOTI1ODcyODMyOTU5MjA2IDc2NTE2MjY2Mzk2Nzk0MTg=