🚀 [Feature]: Add ReleaseType input for explicit release control

action.yml

@@ -49,6 +49,10 @@ inputs:
     description: A comma separated list of labels that do not trigger a release.
     required: false
     default: NoRelease
+  ReleaseType:
+    description: The type of release to create. Values are 'Release' (stable), 'Prerelease', 'Cleanup' (delete old prereleases), or 'None'.
+    required: false
+    default: Release
   WhatIf:
     description: If specified, the action will only log the changes it would make, but will not actually create or delete any releases or tags.
     required: false
@@ -87,6 +91,7 @@ runs:
         PSMODULE_PUBLISH_PSMODULE_INPUT_AutoPatching: ${{ inputs.AutoPatching }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_DatePrereleaseFormat: ${{ inputs.DatePrereleaseFormat }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_IgnoreLabels: ${{ inputs.IgnoreLabels }}
+        PSMODULE_PUBLISH_PSMODULE_INPUT_ReleaseType: ${{ inputs.ReleaseType }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_IncrementalPrerelease: ${{ inputs.IncrementalPrerelease }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_MajorLabels: ${{ inputs.MajorLabels }}
         PSMODULE_PUBLISH_PSMODULE_INPUT_MinorLabels: ${{ inputs.MinorLabels }}

scripts/helpers/Publish-PSModule.ps1

@@ -45,13 +45,18 @@
         $versionPrefix = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_VersionPrefix
         $whatIf = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_WhatIf -eq 'true'
         $ignoreLabels = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_IgnoreLabels -split ',' | ForEach-Object { $_.Trim() }
+        $releaseType = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_ReleaseType  # 'Release', 'Prerelease', 'Cleanup', or 'None'
         $majorLabels = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_MajorLabels -split ',' | ForEach-Object { $_.Trim() }
         $minorLabels = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_MinorLabels -split ',' | ForEach-Object { $_.Trim() }
         $patchLabels = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_PatchLabels -split ',' | ForEach-Object { $_.Trim() }
         $usePRBodyAsReleaseNotes = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRBodyAsReleaseNotes -eq 'true'
         $usePRTitleAsReleaseName = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsReleaseName -eq 'true'
         $usePRTitleAsNotesHeading = $env:PSMODULE_PUBLISH_PSMODULE_INPUT_UsePRTitleAsNotesHeading -eq 'true'
 
+        if ($whatIf) {
+            Write-Host '::warning::WhatIf mode is enabled. No actual releases will be created, no modules will be published, and no tags will be deleted.'
+        }
+
         [pscustomobject]@{
             AutoCleanup              = $autoCleanup
             AutoPatching             = $autoPatching
@@ -60,6 +65,7 @@
             VersionPrefix            = $versionPrefix
             WhatIf                   = $whatIf
             IgnoreLabels             = $ignoreLabels
+            ReleaseType              = $releaseType
             MajorLabels              = $majorLabels
             MinorLabels              = $minorLabels
             PatchLabels              = $patchLabels
@@ -81,28 +87,14 @@
     }
 
     Set-GitHubLogGroup 'Event information - Details' {
-        $defaultBranchName = (gh repo view --json defaultBranchRef | ConvertFrom-Json | Select-Object -ExpandProperty defaultBranchRef).name
-        $isPullRequest = $githubEvent.PSObject.Properties.Name -contains 'pull_request'
-        if (-not ($isPullRequest -or $whatIf)) {
-            Write-Warning '⚠️ A release should not be created in this context. Exiting.'
-            exit
+        if (-not $pull_request) {
+            throw 'GitHub event does not contain pull_request data. This script must be run from a pull_request event.'
         }
-        $actionType = $githubEvent.action
-        $isMerged = $pull_request.merged -eq 'True'
-        $prIsClosed = $pull_request.state -eq 'closed'
-        $prBaseRef = $pull_request.base.ref
         $prHeadRef = $pull_request.head.ref
-        $targetIsDefaultBranch = $pull_request.base.ref -eq $defaultBranchName
 
         Write-Output '-------------------------------------------------'
-        Write-Output "Default branch:                 [$defaultBranchName]"
-        Write-Output "Is a pull request event:        [$isPullRequest]"
-        Write-Output "Action type:                    [$actionType]"
-        Write-Output "PR Merged:                      [$isMerged]"
-        Write-Output "PR Closed:                      [$prIsClosed]"
-        Write-Output "PR Base Ref:                    [$prBaseRef]"
         Write-Output "PR Head Ref:                    [$prHeadRef]"
-        Write-Output "Target is default branch:       [$targetIsDefaultBranch]"
+        Write-Output "ReleaseType:                    [$releaseType]"
         Write-Output '-------------------------------------------------'
     }
 
@@ -117,14 +109,31 @@
     }
 
     Set-GitHubLogGroup 'Calculate release type' {
-        $createRelease = $isMerged -and $targetIsDefaultBranch
-        $closedPullRequest = $prIsClosed -and -not $isMerged
-        $createPrerelease = $labels -contains 'prerelease' -and -not $createRelease -and -not $closedPullRequest
         $prereleaseName = $prHeadRef -replace '[^a-zA-Z0-9]'
 
+        # Validate ReleaseType - must be provided by Get-PSModuleSettings
+        $validReleaseTypes = @('Release', 'Prerelease', 'Cleanup', 'None')
+        if ([string]::IsNullOrWhiteSpace($releaseType)) {
+            Write-Error "ReleaseType input is required. Valid values are: $($validReleaseTypes -join ', ')"
+            exit 1
+        }
+        if ($releaseType -notin $validReleaseTypes) {
+            Write-Error "Invalid ReleaseType: [$releaseType]. Valid values are: $($validReleaseTypes -join ', ')"
+            exit 1
+        }
+
+        $createRelease = $releaseType -eq 'Release'
+        $createPrerelease = $releaseType -eq 'Prerelease'
+        $closedPullRequest = $releaseType -eq 'Cleanup'
+
+        if ($releaseType -eq 'None') {
+            Write-Output 'ReleaseType is None. Skipping release creation.'
+            return
+        }
+
         $ignoreRelease = ($labels | Where-Object { $ignoreLabels -contains $_ }).Count -gt 0
         if ($ignoreRelease) {
-            Write-Output 'Ignoring release creation.'
+            Write-Output 'Ignoring release creation due to ignore label.'
             return
         }
 
@@ -135,12 +144,13 @@
         ).Count -gt 0 -or $autoPatching) -and -not $majorRelease -and -not $minorRelease
 
         Write-Output '-------------------------------------------------'
+        Write-Output "ReleaseType:                    [$releaseType]"
         Write-Output "Create a release:               [$createRelease]"
         Write-Output "Create a prerelease:            [$createPrerelease]"
         Write-Output "Create a major release:         [$majorRelease]"
         Write-Output "Create a minor release:         [$minorRelease]"
         Write-Output "Create a patch release:         [$patchRelease]"
-        Write-Output "Closed pull request:            [$closedPullRequest]"
+        Write-Output "Cleanup prereleases:            [$closedPullRequest]"
         Write-Output '-------------------------------------------------'
     }