$ErrorActionPreference = 'Stop'

<#
██╗     ██╗███╗   ███╗███████╗██╗  ██╗ █████╗ ██╗    ██╗██╗  ██╗
██║     ██║████╗ ████║██╔════╝██║  ██║██╔══██╗██║    ██║██║ ██╔╝
██║     ██║██╔████╔██║█████╗  ███████║███████║██║ █╗ ██║█████╔╝
██║     ██║██║╚██╔╝██║██╔══╝  ██╔══██║██╔══██║██║███╗██║██╔═██╗
███████╗██║██║ ╚═╝ ██║███████╗██║  ██║██║  ██║╚███╔███╔╝██║  ██╗
╚══════╝╚═╝╚═╝     ╚═╝╚══════╝╚═╝  ╚═╝╚═╝  ╚═╝ ╚══╝╚══╝ ╚═╝  ╚═╝
================================================================================
 SCRIPT    : Print Queue Reset 1.2.1
 AUTHOR    : Limehawk.io
 DATE      : January 2026
 USAGE     : .\print_queue_reset.ps1
 FILE      : print_queue_reset.ps1
DESCRIPTION : Resets Windows print queue by clearing spooler directory
================================================================================
 README
--------------------------------------------------------------------------------
PURPOSE

This script resets and clears the Windows print queue by stopping the Print
Spooler service, removing all queued print jobs from the spooler directory,
and restarting the service. This resolves common printing issues caused by
stuck or corrupted print jobs that prevent new documents from printing.

DATA SOURCES & PRIORITY

1. Hardcoded service name and timeout values
2. System spooler directory path ($env:SystemRoot\System32\spool\PRINTERS)
3. Windows Print Spooler service status

REQUIRED INPUTS

- $serviceName: Name of the Print Spooler service (default: "Spooler")
- $stopTimeout: Maximum seconds to wait for service to stop (default: 30)
- $startTimeout: Maximum seconds to wait for service to start (default: 30)

SETTINGS

- Service stop timeout: 30 seconds
- Service start timeout: 30 seconds
- Spooler directory: %SystemRoot%\System32\spool\PRINTERS

BEHAVIOR

1. Validates hardcoded input values
2. Checks current status of Print Spooler service
3. Stops the Print Spooler service if running and waits for handles to release
4. Attempts to remove print job files with retry logic (3 attempts per file)
5. Reports successfully removed and locked files separately
6. Restarts the Print Spooler service (locked files removed on restart)
7. Verifies service is running and reports final status

PREREQUISITES

- Windows operating system
- Administrator privileges (required to manage services and delete files)
- Print Spooler service must exist on the system

SECURITY NOTES

- No secrets in logs
- Requires elevated privileges to modify system services
- Only deletes files from the Windows spooler directory

ENDPOINTS

None - Local system operations only

EXIT CODES

0 = Success - Print queue cleared and service restarted
1 = Failure - Input validation failed, service operations failed, or errors

EXAMPLE RUN

[INFO] INPUT VALIDATION
==============================================================
Service name validated
Stop timeout validated
Start timeout validated

[INFO] SERVICE STATUS CHECK
==============================================================
Service : Spooler
Status  : Running

[RUN] STOPPING PRINT SPOOLER
==============================================================
Stopping service Spooler
Service stopped successfully

[RUN] CLEARING PRINT QUEUE
==============================================================
Spooler Directory : C:\Windows\System32\spool\PRINTERS
Total Files Found : 5
Removing files...
Files Removed     : 5
Queue cleared successfully

[RUN] STARTING PRINT SPOOLER
==============================================================
Starting service Spooler
Service started successfully

[OK] FINAL STATUS
==============================================================
Service : Spooler
Status  : Running
Result  : Print queue cleared and service restarted successfully

[OK] SCRIPT COMPLETED
==============================================================
--------------------------------------------------------------------------------
 CHANGELOG
--------------------------------------------------------------------------------
 2026-01-19 v1.2.1 Updated to two-line ASCII console output style
 2025-12-23 v1.2.0 Updated to Limehawk Script Framework
 2025-01-17 v1.1.0 Add retry logic and handle locked files gracefully
 2025-01-17 v1.0.1 Fix Count property error for single file case
 2025-01-17 v1.0.0 Initial release - Print queue reset script
#>

Set-StrictMode -Version Latest

# ============================================================================
# HARDCODED INPUTS
# ============================================================================

$serviceName  = 'Spooler'
$stopTimeout  = 30
$startTimeout = 30

# ============================================================================
# INPUT VALIDATION
# ============================================================================

Write-Host ""
Write-Host "[INFO] INPUT VALIDATION"
Write-Host "=============================================================="

$errorOccurred = $false
$errorText     = ""

if ([string]::IsNullOrWhiteSpace($serviceName)) {
    $errorOccurred = $true
    if ($errorText.Length -gt 0) { $errorText += "`n" }
    $errorText += "- Service name is required"
}

if ($stopTimeout -lt 1) {
    $errorOccurred = $true
    if ($errorText.Length -gt 0) { $errorText += "`n" }
    $errorText += "- Stop timeout must be at least 1 second"
}

if ($startTimeout -lt 1) {
    $errorOccurred = $true
    if ($errorText.Length -gt 0) { $errorText += "`n" }
    $errorText += "- Start timeout must be at least 1 second"
}

if ($errorOccurred) {
    Write-Host ""
    Write-Host "[ERROR] VALIDATION FAILED"
    Write-Host "=============================================================="
    Write-Host "Input validation failed:"
    Write-Host $errorText
    Write-Host ""
    exit 1
}

Write-Host "Service name validated"
Write-Host "Stop timeout validated"
Write-Host "Start timeout validated"

# ============================================================================
# MAIN SCRIPT
# ============================================================================

try {
    # Check service status
    Write-Host ""
    Write-Host "[INFO] SERVICE STATUS CHECK"
    Write-Host "=============================================================="

    $service = Get-Service -Name $serviceName
    Write-Host "Service : $($service.Name)"
    Write-Host "Status  : $($service.Status)"

    # Stop the Print Spooler service if running
    Write-Host ""
    Write-Host "[RUN] STOPPING PRINT SPOOLER"
    Write-Host "=============================================================="

    if ($service.Status -eq 'Running') {
        Write-Host "Stopping service $serviceName"
        Stop-Service -Name $serviceName -Force

        $waitCount = 0
        while ((Get-Service -Name $serviceName).Status -ne 'Stopped' -and $waitCount -lt $stopTimeout) {
            Start-Sleep -Seconds 1
            $waitCount++
        }

        $service = Get-Service -Name $serviceName
        if ($service.Status -ne 'Stopped') {
            throw "Service failed to stop within $stopTimeout seconds"
        }

        Write-Host "Service stopped successfully"
        Write-Host "Waiting for file handles to release..."
        Start-Sleep -Seconds 2
    } else {
        Write-Host "Service is already stopped"
        Write-Host "Waiting for file handles to release..."
        Start-Sleep -Seconds 2
    }

    # Clear the print queue
    Write-Host ""
    Write-Host "[RUN] CLEARING PRINT QUEUE"
    Write-Host "=============================================================="

    $spoolPath = "$env:SystemRoot\System32\spool\PRINTERS"
    Write-Host "Spooler Directory : $spoolPath"

    $files = Get-ChildItem -Path $spoolPath -File -ErrorAction SilentlyContinue
    $totalFiles = @($files).Count
    $removedCount = 0
    $failedCount = 0
    $failedFilesList = ""

    if ($totalFiles -gt 0) {
        Write-Host "Total Files Found : $totalFiles"
        Write-Host "Removing files..."

        foreach ($file in $files) {
            $removed = $false
            $retryCount = 0
            $maxRetries = 3

            while (-not $removed -and $retryCount -lt $maxRetries) {
                try {
                    Remove-Item -Path $file.FullName -Force -ErrorAction Stop
                    $removed = $true
                    $removedCount++
                } catch {
                    $retryCount++
                    if ($retryCount -lt $maxRetries) {
                        Start-Sleep -Milliseconds 500
                    }
                }
            }

            if (-not $removed) {
                $failedCount++
                if ($failedFilesList.Length -gt 0) { $failedFilesList += "`n" }
                $failedFilesList += "  - $($file.Name)"
            }
        }

        Write-Host "Files Removed     : $removedCount"
        if ($failedCount -gt 0) {
            Write-Host "Files Failed      : $failedCount"
            Write-Host "Locked files:"
            Write-Host $failedFilesList
            Write-Host "Note: Locked files will be removed when service restarts"
        }

        if ($removedCount -gt 0) {
            if ($failedCount -eq 0) {
                Write-Host "Queue cleared successfully"
            } else {
                Write-Host "Queue partially cleared (some files locked)"
            }
        }
    } else {
        Write-Host "Files Found       : 0"
        Write-Host "No print jobs to clear"
    }

    # Start the Print Spooler service
    Write-Host ""
    Write-Host "[RUN] STARTING PRINT SPOOLER"
    Write-Host "=============================================================="

    Write-Host "Starting service $serviceName"
    Start-Service -Name $serviceName

    $waitCount = 0
    while ((Get-Service -Name $serviceName).Status -ne 'Running' -and $waitCount -lt $startTimeout) {
        Start-Sleep -Seconds 1
        $waitCount++
    }

    $service = Get-Service -Name $serviceName
    if ($service.Status -ne 'Running') {
        throw "Service failed to start within $startTimeout seconds"
    }

    Write-Host "Service started successfully"

    # Final status
    Write-Host ""
    Write-Host "[OK] FINAL STATUS"
    Write-Host "=============================================================="

    $service = Get-Service -Name $serviceName
    Write-Host "Service : $($service.Name)"
    Write-Host "Status  : $($service.Status)"
    Write-Host "Result  : Print queue cleared and service restarted successfully"

    Write-Host ""
    Write-Host "[OK] SCRIPT COMPLETED"
    Write-Host "=============================================================="
    Write-Host ""

    exit 0

} catch {
    Write-Host ""
    Write-Host "[ERROR] SCRIPT FAILED"
    Write-Host "=============================================================="
    Write-Host "Failed to reset print queue"
    Write-Host ""
    Write-Host "Error Message : $($_.Exception.Message)"
    Write-Host "Error Location: $($_.InvocationInfo.ScriptLineNumber):$($_.InvocationInfo.OffsetInLine)"
    Write-Host ""
    Write-Host "Troubleshooting:"
    Write-Host "- Ensure script is running with administrator privileges"
    Write-Host "- Verify Print Spooler service exists on this system"
    Write-Host "- Check if another process is locking the spooler directory"
    Write-Host ""
    exit 1
}