action.yml

name: Build-PSModule
description: Build a PowerShell module to the PowerShell Gallery.
author: PSModule

inputs:
  Name:
    description: Name of the module to process.
    required: false
  Version:
    description: |
      The Major.Minor.Patch version to stamp into the built module manifest. When empty, the placeholder '999.0.0'
      is used so local builds still produce a valid manifest.
    required: false
    default: ''
  Prerelease:
    description: |
      Optional prerelease tag (for example 'feature001'). When set, the value is written to PrivateData.PSData.Prerelease
      so the built artifact is a complete prerelease package without any post-build mutation.
    required: false
    default: ''
  ArtifactName:
    description: Name of the artifact to upload.
    required: false
    default: module
  WorkingDirectory:
    description: The working directory where the script will run from.
    required: false
    default: '.'

runs:
  using: composite
  steps:
    - name: Install-PSModuleHelpers
      uses: PSModule/Install-PSModuleHelpers@ed79b6e3aa8c9cd3d30ab2bf02ea6bd4687b9c74 # v1.0.7

    - name: Run Build-PSModule
      shell: pwsh
      id: build
      working-directory: ${{ inputs.WorkingDirectory }}
      env:
        PSMODULE_BUILD_PSMODULE_INPUT_Name: ${{ inputs.Name }}
        PSMODULE_BUILD_PSMODULE_INPUT_Version: ${{ inputs.Version }}
        PSMODULE_BUILD_PSMODULE_INPUT_Prerelease: ${{ inputs.Prerelease }}
      run: |
        # Build-PSModule
        ${{ github.action_path }}/src/main.ps1

    - name: Upload module artifact
      uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
      with:
        name: ${{ inputs.ArtifactName }}
        path: ${{ steps.build.outputs.ModuleOutputFolderPath }}
        if-no-files-found: error
        retention-days: 1