<?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
	 */
	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
	 */
	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
	 */
	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
	 */
	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
	 */
	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
	 */
	public function cleanup(
		string $type,
		PackageInterface $package,
		string $path,
		?PackageInterface $prevPackage = null,
	): PromiseInterface;
}
__halt_compiler();----SIGNATURE:----kaxP1RoxZ0HisFmezI6QZYYj9EUtI00P1tsCMOLdxO6K3301WG25kjYGJllY8fzQoKfCCBMabDBkGRtACnbACRz4iDp7BKgBaAGRh1a8xx2eBM7L81NOUAOdzRKl5/nN/pHmLrUN72Si+Ptgt1DObeWhKK91FVLQaNdn94mu9PEg1r7XSt8hZK9g0yoxW2FEZ22s+Blc8nSrmFplu/iMiJZL88UUexe4hB5P+HtVzqEX9acnVTtrMaWluQjn4e9E7droFl7hv/uiylwOOFRqATi/AC0TEqkV1psVOTUTTTNlTiVD4IPFhkny5RwxDnljsP1VEOh/m3PoYyXwLn/tdaorlI7oqHWEd4KTqvh9fzsZKo3TEjcwide1MD16cLMXpw7w9PjdIOUHhciOQ1SLa8jzdxvsIvle26XrO0hMce/ZA75i1wf3NlR9n0YzR4JY5C8+13Y3yY3mT7Zf7ebKSB8JnKvTF9Ef34/W7c3zBZKOf3reBaBVVq2vk9kY3c8gaGcOfp0UCkP+MatsYkj/3+z3EGUlpFmtXvxNUXT95ITlOosUE8ugovjxt2tNIEmLZ1k+z0xXlydjTqIxbjvrHtiPqc8Kzxhoo9GZDUBwlmq92wEsbWXvNFLgJ2N30sN5E4w9O3OpdU3Ck43JvbA4FsDTVXiNraNT0LuiHzUcoXc=----ATTACHMENT:----NDQ0NjUzODIzMTAwNjUyMSAzMjkxMzY2OTE4MTAwNzgwIDcyODg0NTE2MTk4Nzg5MzY=