github-builder.psm1

# SPDX-License-Identifier: Apache-2.0
# Licensed to the Ed-Fi Alliance under one or more agreements.
# The Ed-Fi Alliance licenses this file to you under the Apache License, Version 2.0.
# See the LICENSE and NOTICES files in the project root for more information.


#requires -version 7

$ErrorActionPreference = "Stop"

<#
.DESCRIPTION
Builds a pre-release version number based on the last tag in the commit history
and the number of commits since then.
#>
function Get-VersionNumber {

    $prefix = "v"

    # Install the MinVer CLI tool
    &dotnet tool install --global minver-cli

    $version = $(&minver -t $prefix)

    "appcommon-v=$version" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
    "appcommon-semver=$($version -Replace $prefix)" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
}

<#
.DESCRIPTION
Builds the EdFi.DataManagementService NuGet package.
#>
function Invoke-DotnetPack {
    [CmdletBinding()]
    param (
        # Package version number
        [string]
        [Parameter(Mandatory = $true)]
        $Version
    )

    &dotnet pack -p:PackageVersion=$Version -o ./
}

<#
.DESCRIPTION
PUblishes any local NuGet packages to the given feed.
#>
function Invoke-NuGetPush {
    [CmdletBinding()]
    param (
        # NuGet package feed / source
        [string]
        [Parameter(Mandatory = $true)]
        $NuGetFeed,

        # API key for authentication
        [string]
        [Parameter(Mandatory = $true)]
        $NuGetApiKey
    )

    (Get-ChildItem -Path $_ -Name -Include *.nupkg) | ForEach-Object {
        &dotnet nuget push $_ --api-key $NuGetApiKey --source $NuGetFeed
    }
}

<#
.DESCRIPTION
Retrieves a list package versions previously published to Azure Artifacts.
#>
function Get-PackagesFromAzure {
    param(
        # Array of packages to look up
        [Parameter(Mandatory=$true)]
        [String[]]
        $Packages
    )

    $uri = "$FeedsURL/packages?api-version=6.0-preview.1"
    $result = @{ }

    foreach ($packageName in $Packages) {
        $packageQueryUrl = "$uri&packageNameQuery=$packageName"
        $packagesResponse = (Invoke-WebRequest -Uri $packageQueryUrl -UseBasicParsing).Content | ConvertFrom-Json
        $latestPackageVersion = ($packagesResponse.value.versions | Where-Object { $_.isLatest -eq $True } | Select-Object -ExpandProperty version)

        Write-Host "Package Name: $packageName"
        Write-Host "Package Version: $latestPackageVersion"

        $result.add(
            $packageName.ToLower().Trim(),
            $latestPackageVersion
        )
    }
    return $result
}

<#
.DESCRIPTION
Promotes a package in Azure Artifacts to a view, e.g. pre-release or release.
#>
function Invoke-Promote {
    [Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSReviewUnusedParameter', '', Justification = 'False positive')]
    param(
        # NuGet package feed / source
        [Parameter(Mandatory = $true)]
        [String]
        $FeedsURL,

        # NuGet Packages API URL
        [Parameter(Mandatory = $true)]
        [String]
        $PackagesURL,

        # Azure Artifacts user name
        [Parameter(Mandatory = $true)]
        [String]
        $Username,

        # Azure Artifacts password
        [Parameter(Mandatory = $true)]
        [SecureString]
        $Password,

        # View to promote into
        [Parameter(Mandatory = $true)]
        [String]
        $View
    )

    $body = @{
        data      = @{
            viewId = $View
        }
        operation = 0
        packages  = @()
    }

    $latestPackages = Get-PackagesFromAzure -Packages "EdFi.Installer.AppCommon"

    foreach ($key in $latestPackages.Keys) {
        $body.packages += @{
            id           = $key
            version      = $latestPackages[$key]
            protocolType = "NuGet"
        }
    }

    $parameters = @{
        Method      = "POST"
        ContentType = "application/json"
        Credential  = New-Object -TypeName PSCredential -ArgumentList $Username, $Password
        URI         = "$PackagesURL/nuget/packagesBatch?api-version=5.0-preview.1"
        Body        = ConvertTo-Json $Body -Depth 10
    }

    $parameters | Out-Host
    $parameters.URI | Out-Host
    $parameters.Body | Out-Host

    $response = Invoke-WebRequest @parameters -UseBasicParsing
    $response | ConvertTo-Json -Depth 10 | Out-Host
}

Export-ModuleMember -Function Get-VersionNumber, Invoke-DotnetPack, Invoke-NuGetPush, Invoke-Promote