Update resources

Author: hugoalh

.github/ISSUE_TEMPLATE/bug-report.yml

@@ -12,8 +12,7 @@ body:
       description: |-
         What the bug is? Add images and/or videos to help for explain this bug if needed.
 
-        > **ℹ️ Notice:**
-        >
+        > [!NOTE]
         > - Should not blur anything in the images and/or videos, except personal secrets.
         > - For external images and/or videos, please ensure we are able to view those.
       placeholder: |-
@@ -27,8 +26,7 @@ body:
       description: |-
         Is this bug reproducible? If reproducible, please show the required steps by list, images, and/or videos!
 
-        > **ℹ️ Notice:**
-        >
+        > [!NOTE]
         > - Should not blur anything in the images and/or videos, except personal secrets.
         > - For external images and/or videos, please ensure we are able to view those.
       placeholder: |-
@@ -55,10 +53,9 @@ body:
       description: |-
         Which versions are affected by this bug?
 
-        > **ℹ️ Notice:**
-        >
+        > [!NOTE]
         > - Accept versions range.
-        > - Versions must be listed as supported in the Security Policy (file: `SECURITY.md`).
+        > - Versions must be listed as supported in the Security Policy (file `SECURITY.md`).
       placeholder: |-
         1.2.3
     validations:
@@ -80,8 +77,7 @@ body:
         - **Variables:** Environment variables.
           > NO_COLOR=1 / ...
 
-        > **ℹ️ Notice:**
-        >
+        > [!NOTE]
         > - Accept multiple execution environments.
         > - All of the properties are optional.
         > - It is recommended to provide this information for reproducible steps.

.github/ISSUE_TEMPLATE/documentation-issue.yml

@@ -20,8 +20,7 @@ body:
       description: |-
         What the issue is? Add images and/or videos to help for explain this issue if needed.
 
-        > **ℹ️ Notice:**
-        >
+        > [!NOTE]
         > - Should not blur anything in the images and/or videos, except personal secrets.
         > - For external images and/or videos, please ensure we are able to view those.
     validations:

.github/labels.yml

@@ -2,11 +2,6 @@
 - name: "Platform/Android"
   color: "#3DDC84"
   description: "Related to Android."
-- name: "Platform/AppleOS"
-  color: "#000000"
-  description: "Related to AppleOS."
-  aliases:
-    - "Platform/MacOS"
 - name: "Platform/Bluesky"
   color: "#0285FF"
   description: "Related to Bluesky."
@@ -16,6 +11,9 @@
 - name: "Platform/ClamAV"
   color: "#B83033"
   description: "Related to ClamAV."
+- name: "Platform/CloudflareWorkers"
+  color: "#F38020"
+  description: "Related to Cloudflare Workers."
 - name: "Platform/CodeQL"
   color: "#FFFFFF"
   description: "Related to CodeQL."
@@ -85,6 +83,11 @@
 - name: "Platform/LinuxUbuntu"
   color: "#E95420"
   description: "Related to Linux Ubuntu."
+- name: "Platform/MacOS"
+  color: "#000000"
+  description: "Related to MacOS."
+  aliases:
+    - "Platform/AppleOS"
 - name: "Platform/Mastodon"
   color: "#6364FF"
   description: "Related to Mastodon."

.github/workflows/publish-powershell-gallery-module.yml renamed to .github/workflows/publish-powershell-module.yml

@@ -1,5 +1,5 @@
 # yaml-language-server: $schema=https://json.schemastore.org/github-workflow.json
-name: "Publish PowerShell Gallery Module"
+name: "Publish PowerShell Module"
 on:
   release:
     types:
@@ -10,9 +10,9 @@ jobs:
     name: "Main"
     permissions:
       contents: "write"
-    uses: "hugoalh/hugoalh/.github/workflows/call-publish-powershell-gallery-module-0.yml@main"
+    uses: "hugoalh/hugoalh/.github/workflows/call-publish-powershell-module-0.yml@main"
     with:
-      build: "_build-package.ps1"
-      path: ".\\hugoalh.GitHubActionsToolkit\\"
+      builder: "_build-package.ps1"
+      context: ".\\hugoalh.GitHubActionsToolkit\\"
     secrets:
       POWERSHELLGALLERY_TOKEN: "${{secrets.POWERSHELLGALLERY_TOKEN}}"

README.md

@@ -1,33 +1,53 @@
 # GitHub Actions Toolkit (PowerShell)
 
-[⚖️ MIT](./LICENSE.md)
+[**⚖️** MIT](./LICENSE.md)
 
-|  | **Release - Latest** | **Release - Pre** |
-|:-:|:-:|:-:|
-| [![GitHub](https://img.shields.io/badge/GitHub-181717?logo=github&logoColor=ffffff&style=flat-square "GitHub")](https://github.com/hugoalh-studio/ghactions-toolkit-powershell) | ![GitHub Latest Release Version](https://img.shields.io/github/release/hugoalh-studio/ghactions-toolkit-powershell?sort=semver&label=&style=flat-square "GitHub Latest Release Version") (![GitHub Latest Release Date](https://img.shields.io/github/release-date/hugoalh-studio/ghactions-toolkit-powershell?label=&style=flat-square "GitHub Latest Release Date")) | ![GitHub Latest Pre-Release Version](https://img.shields.io/github/release/hugoalh-studio/ghactions-toolkit-powershell?include_prereleases&sort=semver&label=&style=flat-square "GitHub Latest Pre-Release Version") (![GitHub Latest Pre-Release Date](https://img.shields.io/github/release-date-pre/hugoalh-studio/ghactions-toolkit-powershell?label=&style=flat-square "GitHub Latest Pre-Release Date")) |
-| [![PowerShell Gallery](https://img.shields.io/badge/PowerShell%20Gallery-0072C6?logo=powershell&logoColor=ffffff&style=flat-square "PowerShell Gallery")](https://www.powershellgallery.com/packages/hugoalh.GitHubActionsToolkit) | ![PowerShell Gallery Latest Release Version](https://img.shields.io/powershellgallery/v/hugoalh.GitHubActionsToolkit?label=&style=flat-square "PowerShell Gallery Latest Release Version") | ![PowerShell Gallery Latest Pre-Release Version](https://img.shields.io/powershellgallery/v/hugoalh.GitHubActionsToolkit?include_prereleases&label=&style=flat-square "PowerShell Gallery Latest Pre-Release Version") |
+**🗂️**
+[![GitHub: hugoalh-studio/ghactions-toolkit-powershell](https://img.shields.io/badge/hugoalh--studio/ghactions--toolkit--powershell-181717?logo=github&logoColor=ffffff&style=flat "GitHub: hugoalh-studio/ghactions-toolkit-powershell")](https://github.com/hugoalh-studio/ghactions-toolkit-powershell)
+[![PowerShell Gallery: hugoalh.GitHubActionsToolkit](https://img.shields.io/badge/hugoalh.GitHubActionsToolkit-0072C6?logo=powershell&logoColor=ffffff&style=flat "PowerShell Gallery: hugoalh.GitHubActionsToolkit")](https://www.powershellgallery.com/packages/hugoalh.GitHubActionsToolkit)
+
+**🆙** ![Latest Release Version](https://img.shields.io/github/release/hugoalh-studio/ghactions-toolkit-powershell?sort=semver&color=2187C0&label=&style=flat "Latest Release Version") (![Latest Release Date](https://img.shields.io/github/release-date/hugoalh-studio/ghactions-toolkit-powershell?color=2187C0&label=&style=flat "Latest Release Date"))
 
 A PowerShell module to provide a better and easier way for GitHub Actions to communicate with the runner machine, and the toolkit for developing GitHub Actions in PowerShell.
 
-## 🔰 Begin
+## 🎯 Target
 
-### PowerShell
+- PowerShell >= v7.2.0
+  > **💽 Require Software**
+  >
+  > - GitHub Actions Runner
+  > - NodeJS >= v16.13.0 *(Optional, for NodeJS based wrapper API)*
 
-- **Target Version:** >= v7.2.0, &:
-  - GitHub Actions Runner >= v2.311.0
-  - NodeJS >= v16.13.0 *\[Optional, for NodeJS based wrapper API\]*
-- **Registry:**
-  - [PowerShell Gallery](https://www.powershellgallery.com/packages/hugoalh.GitHubActionsToolkit)
-    ```ps1
+### 🔗 Other Edition
+
+- NodeJS
+  - [actions/toolkit](https://github.com/actions/toolkit)
+    - [@actions/artifact](https://www.npmjs.com/package/@actions/artifact)
+    - [@actions/cache](https://www.npmjs.com/package/@actions/cache)
+    - [@actions/core](https://www.npmjs.com/package/@actions/core)
+    - [@actions/exec](https://www.npmjs.com/package/@actions/exec)
+    - [@actions/github](https://www.npmjs.com/package/@actions/github)
+    - [@actions/glob](https://www.npmjs.com/package/@actions/glob)
+    - [@actions/http-client](https://www.npmjs.com/package/@actions/http-client)
+    - [@actions/io](https://www.npmjs.com/package/@actions/io)
+    - [@actions/tool-cache](https://www.npmjs.com/package/@actions/tool-cache)
+
+## 🔰 Usage
+
+1. Install via PowerShell:
+    ```pwsh
     Install-Module -Name 'hugoalh.GitHubActionsToolkit' -AcceptLicense
     ```
+2. Import at the script (`<ScriptName>.ps1`):
     ```ps1
     Import-Module -Name 'hugoalh.GitHubActionsToolkit' -Scope 'Local'
     ```
 
 ## 🧩 API (Excerpt)
 
-> **ℹ️ Notice:** Documentation is included inside the script file, can view it via:
+> **ℹ️ Note**
+>
+> For the prettier documentation, can visit via:
 >
 > - [GitHub Repository Wiki](https://github.com/hugoalh-studio/ghactions-toolkit-powershell/wiki)
 
@@ -80,23 +100,8 @@ A PowerShell module to provide a better and easier way for GitHub Actions to com
 ## ✍️ Example
 
 - ```ps1
-  Import-Module -Name 'hugoalh.GitHubActionsToolkit' -Scope 'Local'
-
   Set-GitHubActionsOutput -Name 'foo' -Value 'bar'
-
+  ```
+- ```ps1
   Write-GitHubActionNotice -Message 'Hello, world!'
   ```
-
-## 🔗 Other Edition
-
-- NodeJS
-  - [actions/toolkit](https://github.com/actions/toolkit)
-    - [@actions/artifact](https://www.npmjs.com/package/@actions/artifact)
-    - [@actions/cache](https://www.npmjs.com/package/@actions/cache)
-    - [@actions/core](https://www.npmjs.com/package/@actions/core)
-    - [@actions/exec](https://www.npmjs.com/package/@actions/exec)
-    - [@actions/github](https://www.npmjs.com/package/@actions/github)
-    - [@actions/glob](https://www.npmjs.com/package/@actions/glob)
-    - [@actions/http-client](https://www.npmjs.com/package/@actions/http-client)
-    - [@actions/io](https://www.npmjs.com/package/@actions/io)
-    - [@actions/tool-cache](https://www.npmjs.com/package/@actions/tool-cache)

SECURITY.md

@@ -15,7 +15,7 @@
 | v2.X.X | 🟢 | 2023-12-04 | 2023-12-27 | *Unknown* | >= v2.311.0 | >= v7.2.0 | >= v16.13.0 |
 | v1.7.X | 🔴 | 2023-07-24 | 2023-07-24 | 2024-01-01 | >= v2.303.0 | >= v7.2.0 | >= v14.15.0 |
 
-> **ℹ️ Notice:**
+> **ℹ️ Note**
 >
 > - The date format is according to ISO 8601 standard.
 > - Values in italic format are subject to change.

hugoalh.GitHubActionsToolkit/lib/nodejs-wrapper.psm1

@@ -1,11 +1,9 @@
 #Requires -PSEdition Core -Version 7.2
-[SemVer]$RequireVersionMinimum = [SemVer]::Parse('16.13.0')
+[SemVer]$NodeJsVersionMinimum = [SemVer]::Parse('16.13.0')
 [String]$WrapperRoot = Join-Path -Path $PSScriptRoot -ChildPath '..\nodejs-wrapper'
 [String]$WrapperPackageMetaFilePath = Join-Path -Path $WrapperRoot -ChildPath 'package.json'
 [String]$WrapperScriptFilePath = Join-Path -Path $WrapperRoot -ChildPath 'main.js'
 <#
-.SYNOPSIS
-GitHub Actions - Internal - Invoke NodeJS Wrapper
 .DESCRIPTION
 Invoke NodeJS wrapper.
 .PARAMETER Name
@@ -27,50 +25,37 @@ Function Invoke-NodeJsWrapper {
 		[Parameter(Mandatory = $True, Position = 1)][Alias('Arguments')][Hashtable]$Argument
 	)
 	Try {
-		$CommandMeta = Get-Command -Name 'node' -CommandType 'Application' -ErrorAction 'SilentlyContinue'
-		If ($Null -ieq $CommandMeta) {
-			Throw 'NodeJS is not exist, or not accessible and usable!'
+		If ($Null -eq (Get-Command -Name 'node' -CommandType 'Application' -ErrorAction 'SilentlyContinue')) {
+			Throw 'NodeJS is not exist, accessible, or usable!'
 		}
 		Try {
-			[PSCustomObject]$VersionsTable = node --no-deprecation --no-warnings '--eval=console.log(JSON.stringify(process.versions));' *>&1 |
-				Join-String -Separator "`n" |
-				ConvertFrom-Json -Depth 100
-			[SemVer]$CurrentVersion = [SemVer]::Parse($VersionsTable.node)
+			[SemVer]$NodeJsVersionCurrent = [SemVer]::Parse((
+				node --no-deprecation --no-warnings '--eval=console.log(process.versions.node);' *>&1 |
+					Join-String -Separator "`n"
+			))
 		}
 		Catch {
-			Throw 'NodeJS versions table is not parsable!'
+			Throw 'unable to get NodeJS version!'
 		}
-		If ($RequireVersionMinimum -gt $CurrentVersion) {
-			Throw 'NodeJS is not fulfill the requirement!'
+		If ($NodeJsVersionMinimum -gt $NodeJsVersionCurrent) {
+			Throw "NodeJS version is not fulfill the requirement! Current: $($NodeJsVersionCurrent.ToString()); Expect: >=$($NodeJsVersionMinimum.ToString())"
 		}
-		ForEach ($FilePath In @($WrapperPackageMetaFilePath, $WrapperScriptFilePath)) {
-			If (!(Test-Path -LiteralPath $FilePath -PathType 'Leaf')) {
-				Throw "wrapper resource `"$FilePath`" is missing!"
-			}
+		If (!(Test-Path -LiteralPath $WrapperPackageMetaFilePath -PathType 'Leaf')) {
+			Throw "NodeJS wrapper package meta file ($WrapperPackageMetaFilePath) is missing!"
 		}
-		If ([String]::IsNullOrEmpty($Env:RUNNER_TEMP)) {
-			Throw 'environment variable `RUNNER_TEMP` is not defined!'
-		}
-		If (![System.IO.Path]::IsPathFullyQualified($Env:RUNNER_TEMP)) {
-			Throw "``$Env:RUNNER_TEMP`` (environment variable ``RUNNER_TEMP``) is not a valid absolute path!"
-		}
-		If (!(Test-Path -LiteralPath $Env:RUNNER_TEMP -PathType 'Container')) {
-			Throw "path ``$Env:RUNNER_TEMP`` is not initialized!"
+		If (!(Test-Path -LiteralPath $WrapperScriptFilePath -PathType 'Leaf')) {
+			Throw "NodeJS wrapper script file ($WrapperScriptFilePath) is missing!"
 		}
 	}
 	Catch {
 		Write-Error -Message "This function depends and requires to invoke with the compatible NodeJS environment, but $_" -Category 'ResourceUnavailable'
 		Return
 	}
-	Do {
-		[String]$ExchangeFilePath = Join-Path -Path $Env:RUNNER_TEMP -ChildPath ([System.IO.Path]::GetRandomFileName())
-	}
-	While (Test-Path -LiteralPath $ExchangeFilePath -PathType 'Leaf')
+	[String]$ArgumentStringify = $Argument |
+		ConvertTo-Json -Depth 100 -Compress
+	[String]$Token = (New-Guid).Guid.ToLower() -ireplace '-', ''
 	Try {
-		@{ '$name' = $Name } + $Argument |
-			ConvertTo-Json -Depth 100 -Compress |
-			Set-Content -LiteralPath $ExchangeFilePath -Confirm:$False -Encoding 'UTF8NoBOM'
-		[String]$StdOut = node --no-deprecation --no-warnings $WrapperScriptFilePath $ExchangeFilePath *>&1 |
+		[String]$StdOut = node --no-deprecation --no-warnings $WrapperScriptFilePath $Name $ArgumentStringify $Token *>&1 |
 			Where-Object -FilterScript {
 				If ($_ -imatch '^::.+?::.*$') {
 					Write-Host -Object $_
@@ -82,22 +67,19 @@ Function Invoke-NodeJsWrapper {
 		If ($LASTEXITCODE -ne 0) {
 			Throw "[Exit Code $LASTEXITCODE] $StdOut"
 		}
-		[PSCustomObject]$Result = Get-Content -LiteralPath $ExchangeFilePath -Raw -Encoding 'UTF8NoBOM' |
+		If ($StdOut -inotmatch "(?<=$($Token)\r?\n)(?:.|\r?\n)*?(?=\r?\n$($Token))") {
+			Throw 'No data return.'
+		}
+		[PSCustomObject]$Result = $Matches[0] |
 			ConvertFrom-Json -Depth 100
 		If (!$Result.IsSuccess) {
 			Throw $Result.Reason
 		}
-		$Result.Result |
-			Write-Output
+		Write-Output -InputObject $Result.Result
 	}
 	Catch {
 		Write-Error -Message "Unable to successfully invoke the NodeJS wrapper ``$Name``: $_" -Category 'InvalidData'
 	}
-	Finally {
-		If (Test-Path -LiteralPath $ExchangeFilePath -PathType 'Leaf') {
-			Remove-Item -LiteralPath $ExchangeFilePath -Force -Confirm:$False -ErrorAction 'Continue'
-		}
-	}
 }
 Export-ModuleMember -Function @(
 	'Invoke-NodeJsWrapper'