StratoHiDriveUtils.psm1

<#
.SYNOPSIS
PowerShell module to control STRATO HiDrive and read the configured sync root.

.DESCRIPTION
Provides functions to start and stop the HiDrive desktop app and to determine the
current sync root folder from HiDrive log files.

.EXAMPLE
Import-Module .\StratoHiDriveUtils.psd1 -Force
Start-HiDrive

Loads the module from the current directory and starts HiDrive.

.EXAMPLE
Import-Module .\StratoHiDriveUtils.psd1 -Force
Stop-HiDrive

Loads the module and stops all running HiDrive processes.

.EXAMPLE
Import-Module .\StratoHiDriveUtils.psd1 -Force
Get-HiDriveSyncRoot

Returns the sync root path directly, for example:
C:\Users\<User>\HiDrive

If no entry is available in logs, the function returns $null.

.EXAMPLE
Import-Module .\StratoHiDriveUtils.psd1 -Force
$syncRoot = Get-HiDriveSyncRoot
if ($null -ne $syncRoot) {
	"Sync root: $syncRoot"
} else {
	"No sync root entry found in HiDrive logs."
}

Loads the module and reads the current HiDrive sync root from logs.
#>

Set-StrictMode -Version Latest

function Start-HiDrive {
	<#
	.SYNOPSIS
	Starts the STRATO HiDrive desktop application.

	.DESCRIPTION
	Checks common installation paths and starts HiDrive if the executable exists.
	Throws if no executable is found.
	#>
	[CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')]
	[OutputType([void])]
	param()

	$installationRoots = @(
		$env:ProgramFiles
		${env:ProgramFiles(x86)}
		$env:LocalAppData
	) | Where-Object { $_ }

	$hiDrivePotentialPaths = foreach ($root in $installationRoots) {
		Join-Path $root 'STRATO\HiDrive\HiDrive.App.exe'
	}

	$hiDrivePath = $hiDrivePotentialPaths |
		Where-Object { Test-Path -LiteralPath $_ } |
		Select-Object -First 1

	if (-not $hiDrivePath) {
		throw 'HiDrive.App.exe was not found in known installation paths.'
	}

	if ($PSCmdlet.ShouldProcess($hiDrivePath, 'Start HiDrive application')) {
		Start-Process -FilePath $hiDrivePath -ErrorAction Stop | Out-Null
	}
}

function Stop-HiDrive {
	<#
	.SYNOPSIS
	Stops the STRATO HiDrive desktop application.

	.DESCRIPTION
	Stops all running processes with HiDrive in the process name.
	First requests a graceful close for UI processes and then, after a short wait,
	forces termination of any remaining matching processes.
	#>
	[CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')]
	[OutputType([void])]
	param()

	$processes = Get-Process -Name '*HiDrive*' -ErrorAction SilentlyContinue
	if (-not $processes) {
		return
	}

	$gracefulProcesses = $processes | Where-Object { $_.MainWindowHandle -ne 0 }
	foreach ($process in $gracefulProcesses) {
		if ($PSCmdlet.ShouldProcess("$($process.ProcessName) (PID $($process.Id))", 'Request graceful shutdown')) {
			$null = $process.CloseMainWindow()
		}
	}

	if ($gracefulProcesses) {
		Start-Sleep -Milliseconds 1500
	}

	$remainingProcesses = Get-Process -Name '*HiDrive*' -ErrorAction SilentlyContinue
	if (-not $remainingProcesses) {
		return
	}

	foreach ($process in $remainingProcesses) {
		if ($PSCmdlet.ShouldProcess("$($process.ProcessName) (PID $($process.Id))", 'Force stop remaining process')) {
			Stop-Process -Id $process.Id -Force -ErrorAction SilentlyContinue
		}
	}
}

function Get-HiDriveSyncRoot {
	<#
	.SYNOPSIS
	Returns the HiDrive sync root folder path.

	.DESCRIPTION
	Reads HiDrive logs and extracts the latest root folder path from
	"FileSystemSnapshot: Get file system snapshot started. Root ... |" entries.
	Returns $null if no matching log entry exists.

	.OUTPUTS
	System.String or $null
	#>
	[CmdletBinding()]
	[OutputType([string])]
	param()

	$pattern = 'FileSystemSnapshot: Get file system snapshot started\. Root (?<Root>.+?)\s*\|'

	$logRoot = Join-Path $env:LOCALAPPDATA 'HiDrive\Logs'
	$currentLogPath = Join-Path $logRoot 'log.txt'
	if (Test-Path -LiteralPath $currentLogPath) {
		try {
			$match = Get-Content -LiteralPath $currentLogPath -ErrorAction Stop |
				Select-String -Pattern $pattern |
				Select-Object -Last 1

			if ($match) {
				return $match.Matches[0].Groups['Root'].Value.Trim()
			}
		}
		catch {
			# Continue with legacy fallback if the current log cannot be read.
		}
	}

	$dataRoot = Join-Path $env:LOCALAPPDATA 'HiDrive\Data'
	if (Test-Path -LiteralPath $dataRoot) {
		$candidateDirectories = Get-ChildItem -LiteralPath $dataRoot -Directory -Recurse -Force -ErrorAction SilentlyContinue |
			Where-Object { $_.Name -match '^\d+\.\d+$' } |
			Sort-Object LastWriteTime -Descending

		foreach ($directory in $candidateDirectories) {
			$syncLogPath = Join-Path $directory.FullName 'syncLog.txt'
			if (-not (Test-Path -LiteralPath $syncLogPath)) {
				continue
			}

			try {
				$match = Get-Content -LiteralPath $syncLogPath -ErrorAction Stop |
					Select-String -Pattern $pattern |
					Select-Object -Last 1

				if ($match) {
					return $match.Matches[0].Groups['Root'].Value.Trim()
				}
			}
			catch {
				continue
			}
		}
	}

	return $null
}

Export-ModuleMember -Function Start-HiDrive, Stop-HiDrive, Get-HiDriveSyncRoot