Private/Get-FirebirdReleaseUrl.ps1
|
function Get-FirebirdReleaseUrl { <# .SYNOPSIS Returns the download URL and asset metadata for the Firebird package for a given version and runtime identifier (RID). .PARAMETER Version The Firebird version to install (minimum 3.0.9), as a [semver] object. .PARAMETER RuntimeIdentifier Optional. The runtime identifier (RID) to use. If not provided, uses the current platform RID. .OUTPUTS [PSCustomObject] with Url, FileName, and Version properties. #> [CmdletBinding()] Param( [Parameter(Mandatory)] [semver]$Version, [Parameter()] [ValidateSet('win-x86', 'win-x64', 'win-arm64', 'linux-x64', 'linux-arm64')] [string]$RuntimeIdentifier ) # Cannot use [ValidateRange()] or [ValidateScript()] directly on [semver] parameters $minVersion = [semver]'3.0.9' if ($Version -lt $minVersion) { throw 'Firebird minimal supported version is 3.0.9.' } if (-not $RuntimeIdentifier) { $RuntimeIdentifier = [System.Runtime.InteropServices.RuntimeInformation]::RuntimeIdentifier } Write-VerboseMark -Message "Requested Firebird version: $($Version), RID: $RuntimeIdentifier" $supportedRIDs = @('win-x86', 'win-x64', 'win-arm64', 'linux-x64', 'linux-arm64') if ($supportedRIDs -notcontains $RuntimeIdentifier) { throw "Unsupported RuntimeIdentifier: $RuntimeIdentifier. Supported: $($supportedRIDs -join ', ')" } $apiUrl = 'https://api.github.com/repos/FirebirdSQL/firebird/releases' Write-VerboseMark -Message "Querying GitHub API for releases: $apiUrl" $headers = @{ 'User-Agent' = 'PSFirebird' } # Use an access token for authenticated GitHub API requests (5000 req/hour instead of 60). # Prefer API_GITHUB_ACCESS_TOKEN; fall back to GITHUB_TOKEN (automatically available in GitHub Actions). [string]$githubAccessToken = $env:API_GITHUB_ACCESS_TOKEN if (-not $githubAccessToken) { $githubAccessToken = $env:GITHUB_TOKEN } if ($githubAccessToken) { Write-VerboseMark -Message '- Using authenticated GitHub API requests' $headers['Authorization'] = "Bearer $githubAccessToken" } else { Write-VerboseMark -Message '- Using unauthenticated GitHub API requests (60 req/hour limit)' } $releases = Invoke-RestMethod -Uri $apiUrl -Headers $headers -Verbose:$false $versionString = $Version.ToString() $release = $releases | Where-Object { $_.tag_name -match $versionString } if (-not $release) { throw "Could not find Firebird release for version $versionString on GitHub." } Write-VerboseMark -Message "Found release: $($release.tag_name)" $asset = $null $major = $Version.Major $patternMap = @{} switch ($major) { 5 { $patternMap = @{ 'win-x86' = 'windows-x86.*\.zip$' 'win-x64' = 'windows-x64.*\.zip$' 'win-arm64' = 'windows-arm64.*\.zip$' 'linux-x64' = 'linux-x64.*\.tar\.gz$' 'linux-arm64' = 'linux-arm64.*\.tar\.gz$' } } 4 { $patternMap = @{ 'win-x86' = 'Win32.*\.zip$' 'win-x64' = 'x64.*\.zip$' 'linux-x64' = 'amd64.*\.tar\.gz$|x86_64.*\.tar\.gz$' 'linux-arm64' = 'arm64.*\.tar\.gz$' } } 3 { $patternMap = @{ 'win-x86' = 'Win32.*\.zip$' 'win-x64' = 'x64.*\.zip$' 'linux-x64' = 'amd64.*\.tar\.gz$|x86_64.*\.tar\.gz$' 'linux-arm64' = 'arm64.*\.tar\.gz$' } } default { throw "Unsupported Firebird major version: $major" } } $pattern = $patternMap[$RuntimeIdentifier] if ($RuntimeIdentifier -like 'linux-*') { $asset = $release.assets | Where-Object { $_.name -match $pattern -and $_.name -notmatch 'debug|symbols|pdb' -and $_.name -notmatch 'android' } } else { $asset = $release.assets | Where-Object { $_.name -match $pattern -and $_.name -notmatch 'debug|symbols|pdb' } } if (-not $asset) { throw "Could not find a suitable asset for $RuntimeIdentifier in release $versionString." } $selectedAsset = $asset[0] Write-VerboseMark -Message "Selected asset: $($selectedAsset.name)" $sha256 = if ($selectedAsset.digest -match '^sha256:(.+)$') { $Matches[1] } else { $null } return [PSCustomObject]@{ Version = $Version FileName = $selectedAsset.name Url = $selectedAsset.browser_download_url Sha256 = $sha256 } } |