build.ps1

#Requires -Version 7.0

<#
.SYNOPSIS
    Bootstrap script for IntuneHydrationKit build process
.DESCRIPTION
    Installs required build dependencies (InvokeBuild, Pester, PSScriptAnalyzer)
    and optionally invokes the build process.
.PARAMETER Task
    The build task(s) to run. If not specified, runs the default validation task.
.PARAMETER NoBuild
    Only install dependencies, don't run any build tasks.
.EXAMPLE
    ./build.ps1
    Installs dependencies and runs the default validation task.
.EXAMPLE
    ./build.ps1 -Task Build
    Installs dependencies and runs the Build task.
.EXAMPLE
    ./build.ps1 -Task Analyze, Test, Build
    Installs dependencies and runs multiple tasks.
#>
[CmdletBinding()]
param(
    [Parameter()]
    [string[]]$Task,

    [Parameter()]
    [switch]$NoBuild
)

$ErrorActionPreference = 'Stop'
$InformationPreference = 'Continue'

Write-Information "=== IntuneHydrationKit Build Bootstrap ==="

# Required modules for build process
$requiredModules = @(
    @{ Name = 'InvokeBuild'; MinimumVersion = '5.10.0' }
    @{ Name = 'Pester'; MinimumVersion = '5.4.0' }
    @{ Name = 'PSScriptAnalyzer'; MinimumVersion = '1.21.0' }
    @{ Name = 'Microsoft.Graph.Authentication'; MinimumVersion = '2.0.0' }
)

# Install/update required modules
foreach ($module in $requiredModules) {
    $installed = Get-Module -Name $module.Name -ListAvailable |
        Where-Object { $_.Version -ge [version]$module.MinimumVersion } |
        Sort-Object Version -Descending |
        Select-Object -First 1

    if (-not $installed) {
        Write-Information "Installing $($module.Name) >= $($module.MinimumVersion)..."
        Install-Module -Name $module.Name -MinimumVersion $module.MinimumVersion -Force -Scope CurrentUser -AllowClobber
        Write-Information "  Installed $($module.Name)"
    } else {
        Write-Information "Found $($module.Name) v$($installed.Version)"
    }
}

Write-Information "Bootstrap complete."

# Run build unless explicitly disabled
if (-not $NoBuild) {
    if (-not $Task) {
        $Task = @('.')
    }

    Write-Information ""
    Write-Information "Running build tasks: $($Task -join ', ')"

    $buildScript = Join-Path -Path $PSScriptRoot -ChildPath 'IntuneHydrationKit.build.ps1'
    if (-not (Test-Path $buildScript)) {
        throw "Build script not found: $buildScript"
    }

    Import-Module InvokeBuild -Force
    Invoke-Build -File $buildScript -Task $Task
}