GitHubDownloader

Downloads plugin releases from GitHub. Uses GitHub REST API v3 (no auth required for public repos). Optionally uses GITHUB_TOKEN env var for private repos or rate limits.

public function __construct(?string $token = null):

Parameters

Parameters of __construct()
Name	Type	Description
$token	`?string`

public function parseSource(string $source): array

Parse a source string into owner, repo, and optional version constraint. Formats: "acme/mail-plugin" → owner=acme, repo=mail-plugin, constraint=null "acme/mail-plugin:^2.0" → owner=acme, repo=mail-plugin, constraint=^2.0 "https://github.com/acme/mail-plugin" → owner=acme, repo=mail-plugin, constraint=null

Parameters

Parameters of parseSource()
Name	Type	Description
$source	`string`

Throws

\InvalidArgumentException

public function listVersions(string $owner, string $repo): array

List available versions (releases + tags) from GitHub. Filters to valid semver only.

Parameters

Parameters of listVersions()
Name	Type	Description
$owner	`string`
$repo	`string`

Returns

Sorted descending (newest first)

public function resolveVersion(string $owner, string $repo, ?string $constraint = null): Milpa\ValueObjects\SemanticVersion

Find the best matching version for a constraint.

Parameters

Parameters of resolveVersion()
Name	Type	Description
$owner	`string`
$repo	`string`
$constraint	`(string \| null)`	Semver constraint (e.g., "^2.0", ">=1.5"). If null, returns latest stable.

Throws

\RuntimeException If no matching version found

public function download(string $owner, string $repo, Milpa\ValueObjects\SemanticVersion $version): string

Download and extract a specific version to a temporary directory.

Parameters

Parameters of download()
Name	Type	Description
$owner	`string`
$repo	`string`
$version	`Milpa\ValueObjects\SemanticVersion`

Returns

Path to the extracted plugin directory

Throws

\RuntimeException On download or extraction failure

public function getRepoInfo(string $owner, string $repo): ?array

Get repository info from GitHub API.

Parameters

Parameters of getRepoInfo()
Name	Type	Description
$owner	`string`
$repo	`string`

public function cleanup(string $path): void

Clean up a temporary directory recursively.

Parameters

Parameters of cleanup()
Name	Type	Description
$path	`string`