vscode-powershell.build.ps1

# Copyright (c) Microsoft Corporation.
# Licensed under the MIT License.

param(
    [string]$EditorServicesRepoPath = $null
)

#Requires -Modules @{ModuleName="InvokeBuild";ModuleVersion="3.0.0"}

# Grab package.json data which is used throughout the build.
$script:PackageJson = Get-Content -Raw $PSScriptRoot/package.json | ConvertFrom-Json
$script:IsPreviewExtension = $script:PackageJson.name -like "*preview*" -or $script:PackageJson.displayName -like "*preview*"
Write-Host "`n### Extension Version: $($script:PackageJson.version) Extension Name: $($script:PackageJson.name)`n" -ForegroundColor Green

#region Utility tasks

# TODO: This needs to be a function, not a task.
task ResolveEditorServicesPath -Before CleanEditorServices, BuildEditorServices, TestEditorServices, Package {

    $script:psesRepoPath = `
        if ($EditorServicesRepoPath) {
            $EditorServicesRepoPath
        }
        else {
            "$PSScriptRoot/../PowerShellEditorServices/"
        }

    if (!(Test-Path "$script:psesRepoPath/PowerShellEditorServices.build.ps1")) {
        # Clear the path so that it won't be used
        Write-Warning "`nThe PowerShellEditorServices repo cannot be found at path $script:psesRepoPath`n"
        $script:psesRepoPath = $null
    }
    else {
        $script:psesRepoPath = Resolve-Path $script:psesRepoPath
        $script:psesBuildScriptPath = Resolve-Path "$script:psesRepoPath/PowerShellEditorServices.build.ps1"
    }
}

task UploadArtifacts {
    if ($env:TF_BUILD) {
        # SYSTEM_PHASENAME is the Job name.
        Copy-Item -Path PowerShell-insiders.vsix `
            -Destination "$env:BUILD_ARTIFACTSTAGINGDIRECTORY/$($script:PackageJson.name)-$($script:PackageJson.version)-$env:SYSTEM_PHASENAME.vsix"
    }
}

#endregion
#region Restore tasks

task Restore RestoreNodeModules -If { -not (Test-Path "$PSScriptRoot/node_modules") }

task RestoreNodeModules {

    Write-Host "`n### Restoring vscode-powershell dependencies`n" -ForegroundColor Green

    # When in a CI build use the --loglevel=error parameter so that
    # package install warnings don't cause PowerShell to throw up
    $logLevelParam = if ($env:TF_BUILD) { "--loglevel=error" } else { "" }
    exec { & npm install $logLevelParam }
}

#endregion
#region Clean tasks

task Clean {
    Write-Host "`n### Cleaning vscode-powershell`n" -ForegroundColor Green
    Remove-Item .\modules\* -Exclude "README.md" -Recurse -Force -ErrorAction Ignore
    Remove-Item .\out -Recurse -Force -ErrorAction Ignore
    Remove-Item -Force -Recurse node_modules -ErrorAction Ignore
}

task CleanEditorServices {
    if ($script:psesBuildScriptPath) {
        Write-Host "`n### Cleaning PowerShellEditorServices`n" -ForegroundColor Green
        Invoke-Build Clean $script:psesBuildScriptPath
    }
}

task CleanAll CleanEditorServices, Clean

#endregion
#region Build tasks

task Build Restore, {
    Write-Host "`n### Building vscode-powershell" -ForegroundColor Green
    exec { & npm run compile }
}

task BuildEditorServices {
    # If the PSES codebase is co-located, build it first
    if ($script:psesBuildScriptPath) {
        Write-Host "`n### Building PowerShellEditorServices`n" -ForegroundColor Green
        Invoke-Build Build $script:psesBuildScriptPath
    }
}

task BuildAll BuildEditorServices, Build

#endregion
#region Test tasks

task Test Build, {
    if ($env:TF_BUILD -and $global:IsLinux) {
        Write-Warning "Skipping extension tests in Linux CI because vscode does not support it."
        return
    }
    Write-Host "`n### Running extension tests" -ForegroundColor Green
    exec { & npm run test }
}

task TestEditorServices {
    if ($script:psesBuildScriptPath) {
        Write-Host "`n### Testing PowerShellEditorServices`n" -ForegroundColor Green
        Invoke-Build Test $script:psesBuildScriptPath
    }
}

task TestAll TestEditorServices, Test

#endregion

#region Package tasks

task UpdateReadme -If { $script:IsPreviewExtension } {
    # Add the preview text
    $newReadmeTop = '# PowerShell Language Support for Visual Studio Code

> ## ATTENTION: This is the PREVIEW version of the PowerShell extension for VSCode which contains features that are being evaluated for stable. It works with PowerShell 5.1 and up.
> ### If you are looking for the stable version, please [go here](https://marketplace.visualstudio.com/items?itemName=ms-vscode.PowerShell) or install the extension called "PowerShell" (not "PowerShell Preview")
> ## NOTE: If you have both stable (aka "PowerShell") and preview (aka "PowerShell Preview") installed, you MUST [DISABLE](https://code.visualstudio.com/docs/editor/extension-gallery#_disable-an-extension) one of them for the best performance. Docs on how to disable an extension can be found [here](https://code.visualstudio.com/docs/editor/extension-gallery#_disable-an-extension)'
    $readmePath = (Join-Path $PSScriptRoot README.md)

    $readmeContent = Get-Content -Path $readmePath
    if (!($readmeContent -match "This is the PREVIEW version of the PowerShell extension")) {
        $readmeContent[0] = $newReadmeTop
        $readmeContent | Set-Content $readmePath -Encoding utf8
    }
}

task UpdatePackageJson {
    if ($script:IsPreviewExtension) {
        $script:PackageJson.name = "powershell-preview"
        $script:PackageJson.displayName = "PowerShell Preview"
        $script:PackageJson.description = "(Preview) Develop PowerShell scripts in Visual Studio Code!"
        $script:PackageJson.preview = $true
    } else {
        $script:PackageJson.name = "powershell"
        $script:PackageJson.displayName = "PowerShell"
        $script:PackageJson.description = "Develop PowerShell scripts in Visual Studio Code!"
        $script:PackageJson.preview = $false
    }

    $currentVersion = [version](($script:PackageJson.version -split "-")[0])
    $currentDate = Get-Date

    $revision = if ($currentDate.Month -eq $currentVersion.Minor) {
        $currentVersion.Build + 1
    } else {
        0
    }

    $script:PackageJson.version = "$($currentDate.ToString('yyyy.M')).$revision"

    if ($env:TF_BUILD) {
        $script:PackageJson.version += "-CI.$env:BUILD_BUILDID"
    }

    $Utf8NoBomEncoding = [System.Text.UTF8Encoding]::new($false)
    [System.IO.File]::WriteAllLines(
        (Resolve-Path "$PSScriptRoot/package.json").Path,
        ($script:PackageJson | ConvertTo-Json -Depth 100),
        $Utf8NoBomEncoding)
}

task Package UpdateReadme, {
    if ($script:psesBuildScriptPath -or $env:TF_BUILD) {
        Write-Host "`n### Copying PowerShellEditorServices module files" -ForegroundColor Green
        Copy-Item -Recurse -Force ..\PowerShellEditorServices\module\* .\modules
    } else {
        throw "Unable to find PowerShell EditorServices"
    }

    Write-Host "`n### Packaging PowerShell-insiders.vsix`n" -ForegroundColor Green
    exec { & node ./node_modules/vsce/out/vsce package --no-gitHubIssueLinking }

    # Change the package to have a static name for automation purposes
    Move-Item -Force .\$($script:PackageJson.name)-$($script:PackageJson.version).vsix .\PowerShell-insiders.vsix

    if ($env:TF_BUILD) {
        Copy-Item -Verbose -Recurse "./PowerShell-insiders.vsix" "$env:BUILD_ARTIFACTSTAGINGDIRECTORY/vscode-powershell/PowerShell-insiders.vsix"
        Copy-Item -Verbose -Recurse "./scripts/Install-VSCode.ps1" "$env:BUILD_ARTIFACTSTAGINGDIRECTORY/vscode-powershell/Install-VSCode.ps1"
    }
}

#endregion

# The set of tasks for a release
task Release Clean, Build, Package
# The default task is to run the entire CI build
task . CleanAll, BuildAll, Test, UpdatePackageJson, Package, UploadArtifacts