VSCode-Updater

3.1.0

Private/Invoke-InstallerWrapper.ps1

<#
    SPDX-License-Identifier: MIT
    Copyright (c) 2026 Leon McClatchey, Linktech Engineering LLC
 
    Package: VSCode-Updater
    Author: Leon McClatchey
    Company: Linktech Engineering LLC
    Created: 2026-07-17
    Modified: 2026-07-17
    File: Private/Invoke-InstallerWrapper.ps1
    Version: 1.0.0
    Description: Orchestrates VS Code installer launch, child detection, watchdog monitoring,
                 finalization window, health check, rotation, and fallback handling.
#>
function Invoke-InstallerWrapper {
    [OutputType([WatchdogExitCode])]
    [CmdletBinding()]
    param(
        [Parameter(Mandatory = $true)]
        [string]$InstallerPath,

        [Parameter(Mandatory = $true)]
        [int]$IdleTimeout
    )

    try {
        Clear-SetupBootstrapper | Out-Null
        $parent = Invoke-InstallerDetached -Path $InstallerPath
        $parentPID = $parent.Id

        Write-VSCodeUpdaterLog "[WRAPPER] Parent PID: $parentPID"

        $timeout = 15000   # 15 seconds
        $elapsed = 0
        $interval = 250

        $child = $null
        while ($elapsed -lt $timeout) {

            # direct or indirect worker
            $child = Get-Process -ErrorAction SilentlyContinue |
                Where-Object {
                    $_.Name -match '^is-[A-Za-z0-9]+' -or
                    $_.Name -match 'tmp$' -or
                    $_.Name -match 'tmp\.exe$' -or
                    ($_.Path -and $_.Path -match 'is-[A-Za-z0-9]+\.tmp')
                } |
                Sort-Object StartTime |
                Select-Object -Last 1

            if ($child) { break }

            Start-Sleep -Milliseconds $interval
            $elapsed += $interval
        }

        if (-not $child) {
            Write-VSCodeUpdaterLog "[WRAPPER] No child worker detected"
            return [WatchdogExitCode]::InstallerFailed
        }

        $childPID = $child.Id
        Write-VSCodeUpdaterLog "[WRAPPER] Child PID: $childPID"

        # ---------------------------------------------------------------------
        # Stabilization delay: allow InnoSetup worker to fully initialize
        # ---------------------------------------------------------------------
        Write-VSCodeUpdaterLog "[WRAPPER] Stabilizing child process before watchdog"
        Start-Sleep -Milliseconds 1500

        $result = Invoke-InstallerWatchdog -ChildProcess $child -ParentPID $parentPID -IdleTimeout $IdleTimeout

        switch ($result) {
            "Success"        { return [WatchdogExitCode]::Success }
            "FS-Stalled"     { return [WatchdogExitCode]::FSStalled }
            "Idle-Stalled"   { return [WatchdogExitCode]::IdleStalled }
            "Active-Stalled" { return [WatchdogExitCode]::ActiveStalled }

            # NEW — servicing pre-flight failure
            "ServicingBlocked" {
                Write-VSCodeUpdaterLog "[WRAPPER] Servicing blocked — aborting installer wrapper"
                return [WatchdogExitCode]::ServicingBlocked
            }

            default {
                return [WatchdogExitCode]::InstallerFailed
            }
        }
    }
    catch [InstallerNotFoundException] {
        return [WatchdogExitCode]::InstallerNotFound
    }
    catch [InvalidInstallerExtensionException] {
        return [WatchdogExitCode]::InvalidInstallerExtension
    }
    catch [InstallerTooSmallException] {
        return [WatchdogExitCode]::InstallerTooSmall
    }
    catch [VSCodeRunningUserDeclinedException] {
        return [WatchdogExitCode]::VSCodeRunningUserDeclined
    }
    catch [ExistingInstallerDetectedException] {
        return [WatchdogExitCode]::ExistingInstallerDetected
    }
    catch [InstallerLaunchFailedException] {
        return [WatchdogExitCode]::InstallerLaunchFailed
    }
    catch {
        Write-VSCodeUpdaterLog "[WRAPPER] Exception: $($_.Exception.Message)"
        return [WatchdogExitCode]::InstallerException
    }
}