20230626A

Author: hugoalh

README.md

@@ -33,9 +33,7 @@ Install-Module -Name 'hugoalh.GitHubActionsToolkit' -AcceptLicense
 ```
 
 ```ps1
-<# Either #>
-Import-Module -Name 'hugoalh.GitHubActionsToolkit' -Scope 'Local'# Recommend
-Import-Module -Name 'hugoalh.GitHubActionsToolkit' -Prefix 'GitHubActions' -Scope 'Local'# Changeable Prefix
+Import-Module -Name 'hugoalh.GitHubActionsToolkit' -Prefix 'GitHubActions' -Scope 'Local'
 ```
 
 ### API

hugoalh.GitHubActionsToolkit/module/internal/new-random-token.psm1

@@ -1,5 +1,5 @@
 #Requires -PSEdition Core -Version 7.2
-[Char[]]$PoolMain = [String[]]@(0..9) + [Char[]]@(65..90) + [Char[]]@(97..122)
+[Char[]]$Pool = [String[]]@(0..9) + [Char[]]@(65..90) + [Char[]]@(97..122)
 <#
 .SYNOPSIS
 GitHub Actions - Internal - New Random Token
@@ -16,7 +16,7 @@ Function New-RandomToken {
 	Param (
 		[Parameter(Position = 0)][ValidateRange(1, [Int32]::MaxValue)][Int32]$Length = 32
 	)
-	[Char[]]$PoolCurrent = $PoolMain |
+	[Char[]]$PoolCurrent = $Pool |
 		Get-Random -Shuffle
 	@(1..$Length) |
 		ForEach-Object -Process {

hugoalh.GitHubActionsToolkit/module/nodejs-wrapper.psm1

@@ -5,8 +5,7 @@ Import-Module -Name (
 	) |
 		ForEach-Object -Process { Join-Path -Path $PSScriptRoot -ChildPath "$_.psm1" }
 ) -Prefix 'GitHubActions' -Scope 'Local'
-[SemVer]$NodeJsMinimumVersion = [SemVer]::Parse('14.15.0')
-[RegEx]$SemVerRegEx = 'v?\d+\.\d+\.\d+'
+[SemVer]$NodeJsVersionMinimum = [SemVer]::Parse('14.15.0')
 [String]$WrapperRoot = Join-Path -Path $PSScriptRoot -ChildPath 'nodejs-wrapper'
 [String]$WrapperPackageFilePath = Join-Path -Path $WrapperRoot -ChildPath 'package.json'
 [String]$WrapperScriptFilePath = Join-Path -Path $WrapperRoot -ChildPath 'main.js'
@@ -134,6 +133,9 @@ Function Test-NodeJsEnvironment {
 		[Alias('Redo')][Switch]$Retest,
 		[Alias('Reinstall', 'ReinstallDependency', 'ReinstallPackage', 'ReinstallPackages')][Switch]$ReinstallDependencies# Deprecated, keep as legacy.
 	)
+	If ($PSBoundParameters.ContainsKey('ReinstallDependencies')) {
+		Write-Warning -Message 'Parameter `ReinstallDependencies` is deprecated and will remove in the future version!'
+	}
 	If ($EnvironmentTested -and !$Retest.IsPresent) {
 		Write-Verbose -Message 'Previously tested the NodeJS environment; Return the previous result.'
 		Write-Output -InputObject $EnvironmentResult
@@ -149,12 +151,12 @@ Function Test-NodeJsEnvironment {
 			Throw 'Unable to find NodeJS!'
 		}
 		Try {
-			[String]$NodeJsVersionStdOut = node --no-deprecation --no-warnings --version |
-				Join-String -Separator "`n"
-			If (
-				$NodeJsVersionStdOut -inotmatch $SemVerRegEx -or
-				$NodeJsMinimumVersion -gt [SemVer]::Parse(($Matches[0] -ireplace '^v', ''))
-			) {
+			If ($NodeJsVersionMinimum -gt [SemVer]::Parse((
+				node --no-deprecation --no-warnings --eval='console.log(JSON.stringify(process.versions));' |
+					Join-String -Separator "`n" |
+					ConvertFrom-Json -Depth 100 |
+					Select-Object -ExpandProperty 'node'
+			))) {
 				Throw
 			}
 		}

hugoalh.GitHubActionsToolkit/module/open-id-connect.psm1

@@ -23,6 +23,9 @@ Function Get-OpenIdConnectToken {
 		[Parameter(ValueFromPipelineByPropertyName = $True)][Alias('NodeJs', 'NodeJsWrapper', 'UseNodeJs')][Switch]$UseNodeJsWrapper# Deprecated, keep as legacy.
 	)
 	Process {
+		If ($PSBoundParameters.ContainsKey('UseNodeJsWrapper')) {
+			Write-Warning -Message 'Parameter `UseNodeJsWrapper` is deprecated and will remove in the future version!'
+		}
 		[Hashtable]$Argument = @{}
 		If ($Audience.Length -gt 0) {
 			$Argument.Audience = $Audience

hugoalh.GitHubActionsToolkit/module/utility.psm1

@@ -137,6 +137,9 @@ Function Test-Environment {
 		[Alias('RequiredMessage', 'RequireMessage')][String]$MandatoryMessage = 'This process requires to invoke inside the GitHub Actions environment!',
 		[Switch]$StepSummary# Deprecated, keep as legacy.
 	)
+	If ($PSBoundParameters.ContainsKey('StepSummary')) {
+		Write-Warning -Message 'Parameter `StepSummary` is deprecated and will remove in the future version!'
+	}
 	[Hashtable[]]$Conditions = @(
 		@{ NeedTest = $True; Name = 'CI'; ExpectValue = 'true' },
 		@{ NeedTest = $True; Name = 'GITHUB_ACTION'; },