Private/initFunctions.ps1

function Write-SEPPMAILText {
    <#
    .SYNOPSIS
    Writes text using SEPPMAIL foreground and background colors.
    .PARAMETER Colorset
    Selects Main (#CFDE00 on #034049), Secondary (#F8FBCC on #CACAB7),
    or Action (#A879E1 on #13D38E). Defaults to Main.
    .PARAMETER FgHex
    Overrides the selected color set's foreground color.
    .PARAMETER BgHex
    Overrides the selected color set's background color.
    .EXAMPLE
    Write-SEPPMAILText -Colorset Main -Text 'SomeText'
    #>

    param(
        [string]$Text,
        [string]$FgHex,
        [string]$BgHex,
        [switch]$NoNewline,

        [ValidateSet('Main', 'Secondary', 'Action')]
        [string]$Colorset = 'Main'
    )
    $palette = switch ($Colorset) {
        'Main' { @{ Foreground = '#CFDE00'; Background = '#034049' } }
        'Secondary' { @{ Foreground = '#F8FBCC'; Background = '#CACAB7' } }
        'Action' { @{ Foreground = '#A879E1'; Background = '#13D38E' } }
    }
    if (!$PSBoundParameters.ContainsKey('FgHex')) {
        $FgHex = $palette.Foreground
    }
    if (!$PSBoundParameters.ContainsKey('BgHex')) {
        $BgHex = $palette.Background
    }
    $esc = [char]27
    $fg = $FgHex.TrimStart('#')
    $bg = $BgHex.TrimStart('#')

    $formattedText = "$esc[38;2;$([Convert]::ToInt32($fg.Substring(0,2),16));$([Convert]::ToInt32($fg.Substring(2,2),16));$([Convert]::ToInt32($fg.Substring(4,2),16));48;2;$([Convert]::ToInt32($bg.Substring(0,2),16));$([Convert]::ToInt32($bg.Substring(2,2),16));$([Convert]::ToInt32($bg.Substring(4,2),16))m$Text$esc[0m"

    Write-Host $formattedText -NoNewline:$NoNewline
}

Write-Verbose "Create Helper function for Version checking"
<#
.SYNOPSIS
Parses a semantic version string and converts it into a structured object.
.DESCRIPTION
The `ConvertTo-SemanticVersion` function takes a version string that conforms to the Semantic Versioning (SemVer) standard
and parses it into its components: Major, Minor, Patch, PreRelease, and BuildMetadata. If the input string is not a valid
semantic version, the function throws an error.
The SemVer format includes:
- A version core: `MAJOR.MINOR.PATCH`
- Optional pre-release information: `-<pre-release>`
- Optional build metadata: `+<build-metadata>`
.EXAMPLE
ConvertTo-SemanticVersion -VersionString "1.2.3-alpha+build123"
Returns:
@{
    Major = 1
    Minor = 2
    Patch = 3
    PreRelease = "alpha"
    BuildMetadata = "build123"
}
.EXAMPLE
ConvertTo-SemanticVersion -VersionString "4.5.6"
Returns:
@{
    Major = 4
    Minor = 5
    Patch = 6
    PreRelease = $null
    BuildMetadata = $null
}
.INPUTS
[string]
You must provide a semantic version string as input. The string must conform to the SemVer format.
.OUTPUTS
[hashtable]
The function returns a hashtable with the following keys:
- `Major` ([int]): The major version number.
- `Minor` ([int]): The minor version number.
- `Patch` ([int]): The patch version number.
- `PreRelease` ([string]): The pre-release label, or `$null` if not specified.
- `BuildMetadata` ([string]): The build metadata, or `$null` if not specified.
.NOTES
- The function validates the format of the input string using a regular expression.
- If the input does not conform to the SemVer format, an exception is thrown.
.LINK
Semantic Versioning Specification: https://semver.org/
#>

function ConvertTo-SemanticVersion {
    param (
        [string]$VersionString
    )

    if ($VersionString -match '^(\d+)\.(\d+)\.(\d+)(?:-([\w\-\.]+))?(?:\+([\w\-\.]+))?$') {
        return @{
            Major        = [int]$matches[1]
            Minor        = [int]$matches[2]
            Patch        = [int]$matches[3]
            PreRelease   = $matches[4]
            BuildMetadata = $matches[5]
        }
    }
    else {
        throw "Invalid semantic version format: $VersionString"
    }
}
function Invoke-RepoInstall {
    param (
        [string]$artefact,
        [string]$artefactVersion
    )
    if (!(Get-Command -Name 'Install-PSResource' -ErrorAction SilentlyContinue)) {
        #$RepoInstallMethod = 'Module'
        $InstCommandString = "Install-Module $artefact -requiredVersion $artefactVersion -force -WarningAction SilentlyContinue"
    } else {
        $InstCommandString = "Install-PSResource $artefact -Version $artefactVersion -Reinstall -WarningAction SilentlyContinue"
    }
    Invoke-Expression $InstCommandString
}

# SIG # Begin signature block
# MIIQVQYJKoZIhvcNAQcCoIIQRjCCEEICAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCB2jBvF4k0u7SLJ
# ZC0T+zhnhcZdvoHMuIuii71CvzqooKCCDJEwggYaMIIEAqADAgECAhBiHW0MUgGe
# O5B5FSCJIRwKMA0GCSqGSIb3DQEBDAUAMFYxCzAJBgNVBAYTAkdCMRgwFgYDVQQK
# Ew9TZWN0aWdvIExpbWl0ZWQxLTArBgNVBAMTJFNlY3RpZ28gUHVibGljIENvZGUg
# U2lnbmluZyBSb290IFI0NjAeFw0yMTAzMjIwMDAwMDBaFw0zNjAzMjEyMzU5NTla
# MFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQxKzApBgNV
# BAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwggGiMA0GCSqG
# SIb3DQEBAQUAA4IBjwAwggGKAoIBgQCbK51T+jU/jmAGQ2rAz/V/9shTUxjIztNs
# fvxYB5UXeWUzCxEeAEZGbEN4QMgCsJLZUKhWThj/yPqy0iSZhXkZ6Pg2A2NVDgFi
# gOMYzB2OKhdqfWGVoYW3haT29PSTahYkwmMv0b/83nbeECbiMXhSOtbam+/36F09
# fy1tsB8je/RV0mIk8XL/tfCK6cPuYHE215wzrK0h1SWHTxPbPuYkRdkP05ZwmRmT
# nAO5/arnY83jeNzhP06ShdnRqtZlV59+8yv+KIhE5ILMqgOZYAENHNX9SJDm+qxp
# 4VqpB3MV/h53yl41aHU5pledi9lCBbH9JeIkNFICiVHNkRmq4TpxtwfvjsUedyz8
# rNyfQJy/aOs5b4s+ac7IH60B+Ja7TVM+EKv1WuTGwcLmoU3FpOFMbmPj8pz44MPZ
# 1f9+YEQIQty/NQd/2yGgW+ufflcZ/ZE9o1M7a5Jnqf2i2/uMSWymR8r2oQBMdlyh
# 2n5HirY4jKnFH/9gRvd+QOfdRrJZb1sCAwEAAaOCAWQwggFgMB8GA1UdIwQYMBaA
# FDLrkpr/NZZILyhAQnAgNpFcF4XmMB0GA1UdDgQWBBQPKssghyi47G9IritUpimq
# F6TNDDAOBgNVHQ8BAf8EBAMCAYYwEgYDVR0TAQH/BAgwBgEB/wIBADATBgNVHSUE
# DDAKBggrBgEFBQcDAzAbBgNVHSAEFDASMAYGBFUdIAAwCAYGZ4EMAQQBMEsGA1Ud
# HwREMEIwQKA+oDyGOmh0dHA6Ly9jcmwuc2VjdGlnby5jb20vU2VjdGlnb1B1Ymxp
# Y0NvZGVTaWduaW5nUm9vdFI0Ni5jcmwwewYIKwYBBQUHAQEEbzBtMEYGCCsGAQUF
# BzAChjpodHRwOi8vY3J0LnNlY3RpZ28uY29tL1NlY3RpZ29QdWJsaWNDb2RlU2ln
# bmluZ1Jvb3RSNDYucDdjMCMGCCsGAQUFBzABhhdodHRwOi8vb2NzcC5zZWN0aWdv
# LmNvbTANBgkqhkiG9w0BAQwFAAOCAgEABv+C4XdjNm57oRUgmxP/BP6YdURhw1aV
# cdGRP4Wh60BAscjW4HL9hcpkOTz5jUug2oeunbYAowbFC2AKK+cMcXIBD0ZdOaWT
# syNyBBsMLHqafvIhrCymlaS98+QpoBCyKppP0OcxYEdU0hpsaqBBIZOtBajjcw5+
# w/KeFvPYfLF/ldYpmlG+vd0xqlqd099iChnyIMvY5HexjO2AmtsbpVn0OhNcWbWD
# RF/3sBp6fWXhz7DcML4iTAWS+MVXeNLj1lJziVKEoroGs9Mlizg0bUMbOalOhOfC
# ipnx8CaLZeVme5yELg09Jlo8BMe80jO37PU8ejfkP9/uPak7VLwELKxAMcJszkye
# iaerlphwoKx1uHRzNyE6bxuSKcutisqmKL5OTunAvtONEoteSiabkPVSZ2z76mKn
# zAfZxCl/3dq3dUNw4rg3sTCggkHSRqTqlLMS7gjrhTqBmzu1L90Y1KWN/Y5JKdGv
# spbOrTfOXyXvmPL6E52z1NZJ6ctuMFBQZH3pwWvqURR8AgQdULUvrxjUYbHHj95E
# jza63zdrEcxWLDX6xWls/GDnVNueKjWUH3fTv1Y8Wdho698YADR7TNx8X8z2Bev6
# SivBBOHY+uqiirZtg0y9ShQoPzmCcn63Syatatvx157YK9hlcPmVoa1oDE5/L9Uo
# 2bC5a4CH2RwwggZvMIIE16ADAgECAhBIqMP3CCLHOHtOKuaWNyeFMA0GCSqGSIb3
# DQEBDAUAMFQxCzAJBgNVBAYTAkdCMRgwFgYDVQQKEw9TZWN0aWdvIExpbWl0ZWQx
# KzApBgNVBAMTIlNlY3RpZ28gUHVibGljIENvZGUgU2lnbmluZyBDQSBSMzYwHhcN
# MjYwNDE1MDAwMDAwWhcNMjcwNzE0MjM1OTU5WjBmMQswCQYDVQQGEwJERTEPMA0G
# A1UECAwGQmF5ZXJuMSIwIAYDVQQKDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJI
# MSIwIAYDVQQDDBlTRVBQbWFpbCBEZXV0c2NobGFuZCBHbWJIMIICIjANBgkqhkiG
# 9w0BAQEFAAOCAg8AMIICCgKCAgEAvAFzE8MbJpvQt+IdIh1M+bKYsJBFDk4b9ySe
# 25IrCi00B9o5XmQtIw42MqyIKbUq1tDARtp9KTQedEP9W+rflAF2l+0Z046Jkiqu
# mU9/enbqWLDyln1aS/p7HOgwZFMhnsR9zH0MfFckiklUmkzJO+vmzYAK7ZmDxajN
# LJs0gkGRU2/BecAx/TSvLXMaKONsKZCyMKQCnwo1mCY/tFl5EgUz7YQFrPORBQGf
# Qke/hkdBfQDqNRsi/J6+KhJWc6LvgQihdRg/INQbQsTxlow18NWvyFsjjueH7kG6
# HR4YKfbv07xgrsIh8xvq9ZJ1SBhLXmkg4SdoQGASjqR6o3keAX+bDRFf+hmlWWJp
# /FqVHR5QomF3vbK2/bbz4jAclYSPx/sPasNJ0YnKFkgmowZ7Ysa0KA0/egBgtI4g
# J+8V7zrqIVEG3rMQh9KCdMnJqP2aM9o4gUzQvE1M4x606liX9EWwdLLS+fe79o+F
# zo5oH4wBE/En6hQQkzseHHu+TXCDd6zUUZ/PlTK0gTaDIRXt6UzPNqJ4RiRCW2pN
# FcPt078qqVTuwKUXoE4ufxGgXKFrZlCYST/9eG1TnW2oq19nz8A333GCsL3gpoNI
# KvfmDyGMMNzvx2aeqn2v6e75z8kH19iGSNZ51xT+WgS9F1aIvjz08/T7XAv7iDPF
# 1/gPIp8CAwEAAaOCAakwggGlMB8GA1UdIwQYMBaAFA8qyyCHKLjsb0iuK1SmKaoX
# pM0MMB0GA1UdDgQWBBS30/Tq+alF3j2BY5up8n5zpAU23DAOBgNVHQ8BAf8EBAMC
# B4AwDAYDVR0TAQH/BAIwADATBgNVHSUEDDAKBggrBgEFBQcDAzBKBgNVHSAEQzBB
# MDUGDCsGAQQBsjEBAgEDAjAlMCMGCCsGAQUFBwIBFhdodHRwczovL3NlY3RpZ28u
# Y29tL0NQUzAIBgZngQwBBAEwSQYDVR0fBEIwQDA+oDygOoY4aHR0cDovL2NybC5z
# ZWN0aWdvLmNvbS9TZWN0aWdvUHVibGljQ29kZVNpZ25pbmdDQVIzNi5jcmwweQYI
# KwYBBQUHAQEEbTBrMEQGCCsGAQUFBzAChjhodHRwOi8vY3J0LnNlY3RpZ28uY29t
# L1NlY3RpZ29QdWJsaWNDb2RlU2lnbmluZ0NBUjM2LmNydDAjBggrBgEFBQcwAYYX
# aHR0cDovL29jc3Auc2VjdGlnby5jb20wHgYDVR0RBBcwFYETc3VwcG9ydEBzZXBw
# bWFpbC5jaDANBgkqhkiG9w0BAQwFAAOCAYEAi7fmb5UYoemWG3CC4K2UZWVrR6GO
# fi8gbJKgjPbKO4zrCrU/x6cOdyp6scKZfUEGFDf8KH6pP4pAQv1Hsbi49gU2kxoU
# WLlCiipn05qJY663DHx9hlStej/ZdEatou0wyCDiG5xD7kmG+1t6iLyyCBgEB88t
# JpzTjI61qXmBTS/FGEOAsB4SDEW1ngA7bc5FOv4IUKA43hp8M+N3GeYFzDqwJELY
# EfVVYheBW3o7q4VrCdfFEuaQihOtvfDfYpP6ANgekNn8HdsMT8rx9D1I50Rli/qQ
# Fo2BOuPyb2SIQPzJvCs5wgi5qgp1nHiN6igumu2Cz7BmGjOazGUgCSUY5QwyE8+F
# +R2tVM+2O15rfX01+e56ZfojBEiEjMwfPHs3fa3V3gokWWNwUMkton/v0R/nl2zj
# mOr2okohOINZEDh9frg21zUCN5ZD8Y4zQWuiJLCvvvBZs0JR4c9xl2k2wtw/QLPh
# GU69zM3smGpRoLE8M6zvUvSU7jXjvefazUniMYIDGjCCAxYCAQEwaDBUMQswCQYD
# VQQGEwJHQjEYMBYGA1UEChMPU2VjdGlnbyBMaW1pdGVkMSswKQYDVQQDEyJTZWN0
# aWdvIFB1YmxpYyBDb2RlIFNpZ25pbmcgQ0EgUjM2AhBIqMP3CCLHOHtOKuaWNyeF
# MA0GCWCGSAFlAwQCAQUAoIGEMBgGCisGAQQBgjcCAQwxCjAIoAKAAKECgAAwGQYJ
# KoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYKKwYBBAGCNwIBCzEOMAwGCisGAQQB
# gjcCARUwLwYJKoZIhvcNAQkEMSIEIAGO7gAP3bWa6io4BVNkICw9tIcrap8gjWrb
# 48ouzYLnMA0GCSqGSIb3DQEBAQUABIICAHd/3TcUl/IcSLLxZbK7R6Rp1uPpcy7x
# HGKYZTb8XBJADUV3HLdiyzgezOv/9hiu3Pt6nCkav9+S/rdUybXldvyfqazmyDzi
# uvTwXZ6+kC7hEyw4i6AMGtxDh7uhc+v8ZgLnjErjgNQ9sOBZsSLfrGFVM7XIESu/
# uygGhf/aVSYvyiaqRTBVOwLElcxWmCkQPUvATSZoiYP1DyDoxXOM1Q22NsUS7+A2
# rBoOQCIuUr9dndTBLXdFrYGbDwJ26qAY4BZkEzLRdBVBGJUmIeKOnvC/JGUMWhQb
# s/CWZOcEJ1L/jpYsvFaN3Joz2jRo/Y3Vsepl10/T1n9RcgPjEbRX0qL7dakcNrW3
# 4d82X7DWOA3uKTQD44+Cp/Xw/TNfhyvIq2iw4kLsCiaqyiMg1R/fKhp/VF6w3kRJ
# pxkkYejh0v+WXqybY8ZC8lgL80k6fJfdb6IMob1veOYHNHBdRfqj62IZ+3N+jZe4
# pObTP41vTHqLV3/u39sZougWhHJ2eB5pANLDfhvCZUDrc+TIFkuz7+uDmiHYawC+
# /bmf9X8UHYTsTyVIPHUb090Aj5sah90ON1TYFpRfhs1GlzJ66XqO9pfrAR+TQmEd
# 44GGvwJl7tgamKFc5OC8LojPlxKN/UlTWFk8gir+iLiF4Pzn9RXdjvRuCLP0HaG8
# Jja4PbgVRk7z
# SIG # End signature block