Private/Exceptions/AvmExceptions.ps1

#Requires -Version 7.4

# Typed exception classes. Avm.Authoring.psm1 dot-sources
# this file before every other Private/ file, reusing one parsed copy per
# runspace so the class types stay stable across Import-Module -Force.
#
# The base class derives from System.Exception so that our own throws look the
# same as framework exceptions to PowerShell's exception machinery and to
# Pester's -ExceptionType assertions.

class AvmException : System.Exception {
    [string] $Code

    AvmException([string] $message) : base($message) {
        $this.Code = 'AVM0000'
    }

    AvmException([string] $message, [string] $code) : base($message) {
        $this.Code = $code
    }

    AvmException([string] $message, [Exception] $innerException) : base($message, $innerException) {
        $this.Code = 'AVM0000'
    }

    AvmException([string] $message, [string] $code, [Exception] $innerException) : base($message, $innerException) {
        $this.Code = $code
    }
}

# Bad config, missing required env var, invalid manifest.
class AvmConfigurationException : AvmException {
    AvmConfigurationException([string] $message) : base($message, 'AVM1001') {}
    AvmConfigurationException([string] $message, [Exception] $innerException) : base($message, 'AVM1001', $innerException) {}
}

# A verb that does not apply to the resolved ecosystem, or is not implemented
# for it yet. Distinct from AvmConfigurationException - which means the repo is
# misconfigured and someone must fix it - so the gauntlets can skip the former
# and fail the latter. Derives from AvmConfigurationException so existing
# catches and the CLI's exit-code handling keep working unchanged.
class AvmNotSupportedException : AvmConfigurationException {
    AvmNotSupportedException([string] $message) : base($message) {}
}

# Tool resolver / install / SHA256 mismatch / archive issues.
class AvmToolException : AvmException {
    AvmToolException([string] $message) : base($message, 'AVM1010') {}
    AvmToolException([string] $message, [string] $code) : base($message, $code) {}
    AvmToolException([string] $message, [Exception] $innerException) : base($message, 'AVM1010', $innerException) {}
    AvmToolException([string] $message, [string] $code, [Exception] $innerException) : base($message, $code, $innerException) {}
}

# Subprocess exited non-zero or could not be started. Carries captured streams.
class AvmProcessException : AvmException {
    [string] $FileName
    [string[]] $ArgumentList
    [int] $ExitCode
    [string] $StdOut
    [string] $StdErr

    AvmProcessException([string] $message) : base($message, 'AVM1020') {}

    AvmProcessException(
        [string] $message,
        [string] $fileName,
        [string[]] $argumentList,
        [int] $exitCode,
        [string] $stdOut,
        [string] $stdErr
    ) : base($message, 'AVM1020') {
        $this.FileName = $fileName
        $this.ArgumentList = $argumentList
        $this.ExitCode = $exitCode
        $this.StdOut = $stdOut
        $this.StdErr = $stdErr
    }
}

# Repo context resolver couldn't classify the path.
class AvmContextException : AvmException {
    AvmContextException([string] $message) : base($message, 'AVM1030') {}
    AvmContextException([string] $message, [Exception] $innerException) : base($message, 'AVM1030', $innerException) {}
}

# A dispatched avm command completed with Status 'fail' or 'error'. Thrown at
# the public dispatch boundary (Invoke-Avm) so the hosting process exits
# non-zero and wrapping git hooks / CI steps cannot pass silently. Carries the
# structured engine result so callers that catch it keep full diagnostics.
class AvmCommandException : AvmException {
    [string] $Verb
    [string] $CommandStatus
    [object] $Result

    AvmCommandException([string] $verb, [string] $commandStatus, [object] $result) : base(
        "avm $verb reported Status '$commandStatus'.", 'AVM1040') {
        $this.Verb = $verb
        $this.CommandStatus = $commandStatus
        $this.Result = $result
    }

    AvmCommandException([string] $verb, [string] $commandStatus, [object] $result, [string] $detail) : base(
        $(if ([string]::IsNullOrWhiteSpace($detail)) {
                "avm $verb reported Status '$commandStatus'."
            }
            else {
                "avm $verb reported Status '$commandStatus'. $detail"
            }), 'AVM1040') {
        $this.Verb = $verb
        $this.CommandStatus = $commandStatus
        $this.Result = $result
    }
}

class AvmModuleVersionException : AvmException {
    [version] $CurrentVersion
    [version] $LatestVersion
    [int] $ExitCode

    AvmModuleVersionException(
        [version] $currentVersion,
        [version] $latestVersion,
        [string] $message
    ) : base($message, 'AVM1050') {
        $this.CurrentVersion = $currentVersion
        $this.LatestVersion = $latestVersion
        $this.ExitCode = 10
    }
}

class AvmGalleryLookupException : System.Exception {
    AvmGalleryLookupException([string] $message) : base($message) {}
    AvmGalleryLookupException([string] $message, [Exception] $innerException) : base($message, $innerException) {}
}

# A module repository is pinned to a managed-files release whose major version
# has been superseded. Terminating because a major is the mechanism by which a
# breaking managed-file change is forced onto the fleet: syncing at the stale
# pin would quietly leave the repository on the superseded contract.
class AvmManagedFilesVersionException : AvmException {
    [string] $PinnedVersion
    [string] $LatestVersion
    [int] $ExitCode

    AvmManagedFilesVersionException(
        [string] $message
    ) : base($message, 'AVM1060') {
        $this.ExitCode = 11
    }

    AvmManagedFilesVersionException(
        [string] $pinnedVersion,
        [string] $latestVersion,
        [string] $message
    ) : base($message, 'AVM1060') {
        $this.PinnedVersion = $pinnedVersion
        $this.LatestVersion = $latestVersion
        $this.ExitCode = 11
    }
}

# The managed-files tag listing could not be reached or returned nothing
# usable. Non-terminating by convention: callers warn and continue against the
# recorded pin, mirroring how AvmGalleryLookupException is handled.
class AvmManagedFilesLookupException : System.Exception {
    AvmManagedFilesLookupException([string] $message) : base($message) {}
    AvmManagedFilesLookupException([string] $message, [Exception] $innerException) : base($message, $innerException) {}
}

# A GitHub REST call made through the GitHub CLI failed. StatusCode is the HTTP
# status reported by gh, or 0 when the request did not produce one.
class AvmGitHubException : AvmException {
    [int] $StatusCode

    AvmGitHubException([string] $message, [int] $statusCode) : base($message, 'AVM1070') {
        $this.StatusCode = $statusCode
    }
}

# SIG # Begin signature block
# MIInKgYJKoZIhvcNAQcCoIInGzCCJxcCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCiSSFbccr7bQtU
# kHGAaqPid/qcn0QxPLYdAZQyAHt53qCCDLowggX1MIID3aADAgECAhMzAAACHU0Z
# yE7XD1dIAAAAAAIdMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD
# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD
# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQzWhcNMjcwNDE1MTg1
# OTQzWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD
# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB
# DwAwggEKAoIBAQDQvewXxx9gZZFC6Ys1WBay8BJ8kGA4JQnH5CMafqOASlTpK9H8
# o5ZXTXt0caVQTNMUPt445wXYD+dFtaKWTwDn1I52oUSrC9vJin1Gsqt+zyKJL5Dg
# 3eQXbQNR61DmMy20GLTIO3SFed9Rfi/ophgCLGFLDR3r0KvHjwMb/jYWS0celV/4
# Lz27LfAekm8v9E5IXaeiXbAUYZKK090n4CVl3JBtbN+9DtI9SNu/yjvozW52/u7R
# X/Ttpa/KDlpuokZ+Zcbvmtd9ur9gFLvZzh41o9MsE/clQtdaFWGvuo6Jua/ntpgk
# ey3E5/vBFe+MJPG6phdnuo6r57ZudCudiI1bAgMBAAGjggGbMIIBlzAOBgNVHQ8B
# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O
# BBYEFH6QuMwqcPG0hQlQ6c5jCtTTLrVeMEUGA1UdEQQ+MDykOjA4MR4wHAYDVQQL
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xFjAUBgNVBAUTDTIzMDAxMis1MDc1NTkw
# HwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEwYAYDVR0fBFkwVzBVoFOg
# UYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0
# JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNybDBtBggrBgEFBQcBAQRh
# MF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMv
# Y2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy
# dDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4ICAQBKTbYOjzwTG/DXGaz9
# s6+fQeaTtDcFmMY+5UyVFCyj7Pv+5i37qfX8lSL/tBIfYQfWsMuBQlfZurJD6r4H
# VJ2CeH+1fgiq8dcHdVKoZ3Sa2qXoX3cq9iS8cVb06B7+5/XJ7I0OxHH9fDsvJ3T3
# w5V/ZtAIFmLrl+P0CtG+92uzRsn0nTbdFjOkLMLWPLAU3THohKRlSEMgFJpPkm5n
# 5UAZ35xX6FWCrDLsSKb555bTifwa8mJBwdlof0bmfYidH+dxZ1FdDxvLnNl9zeKs
# A4kejaaIqqIPguhwAti5Ql7BlTNoJNwxCvBmqW2MQLnCkYN/VVUsR3V2x/rcTNzo
# Bf/Z/SpROvdaA2ZOOd1uioXJt3tdLQ7vHpqpib0KfWr/FWXW10q38VxfCnRQBqzb
# SuztR7nEMuzX7Ck+B/XaPDXd1qh72+QYyB0Z2VzWmO9zsnb9Uq/dwu8LGeQqnyu6
# 7SDGACvnXii2fb9+US492VTnXSnFKyqwgzUyFMtZK1/sHYTv6bG4TtQUygQxTN+Z
# V+aJIlKO2MqZ7bKrAnOzS9m6NgoTdWOq11bTOZwKlIEV/EhV9SWkDmdpR/hPPT2v
# 6TEj4F8PT/zHjRezIU5c/DGlt/VhY/pK0XkJtEyMmmS1BMtjU/rqBZVMIm3dnxQs
# /TBByr+Cf8Z1r7aifQVQ+WSqzjCCBr0wggSloAMCAQICEzMAAAA5O7Y3Gb8GHWcA
# AAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX
# YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg
# Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl
# IEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoXDTM2MDMyMjIyMTMwNFow
# VzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEo
# MCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQQ0EgMjAyNDCCAiIwDQYJ
# KoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeqlRYHNa265v4IY9fH8TKh
# emHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo0dtS/EW6I/yEL/bLSY8h
# KpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATvQVL4tcf03aTycsz8QeCd
# M0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a1uv1zerOYMnsneRRwCbp
# yW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1FyQfK0fVkaya8SmVHQ/t
# Of23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfOGSWHIIV4YrTJTT6PNty5
# REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7ttOu1bVnXfHaqPYl2rPs
# 20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJuz2MXMCt7iw7lFPG9LXK
# Gjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxSCwyoGIq0PhaA7Y+VPct5
# pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOmVQop36wUVUYklUy++vDW
# eEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3SkE/xIkgpfl22MM1itkZ
# 35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8EBAMCAYYwEAYJKwYBBAGC
# NxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPXLQaUEggxMBkGCSsGAQQB
# gjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU
# ci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBPoE2gS4ZJaHR0cDovL2Ny
# bC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0MjAx
# MV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAwTgYIKwYBBQUHMAKGQmh0
# dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0MjAx
# MV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOCAgEAFJQfOChP7onn6fLI
# MKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D5W4wMwYeLystcEqfkjz4
# NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBYnbu0+THSuVHTe0VTTPVh
# ily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSIvgn0JksVBVMYVI5QFu/q
# hnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6aR9y34aiM1qmxaxBi6OU
# nyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4wPKC5OmHm1DQIt/MNokbb
# H3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7RTX8AdBPo0I6OEojf39z
# uFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK/fg8B2qjW88MT/WF5V5u
# vZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSKYBv0VisCzfxgeU+dquXW
# 9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkwYTu/9dLeH2pDqeJZAABV
# DWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVTQl0v4q8J/AUmQN5W4n10
# 1cY2L4A7GTQG1h32HHAvfQESWP0xghnGMIIZwgIBATBuMFcxCzAJBgNVBAYTAlVT
# MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv
# c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w
# DQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwLwYJ
# KoZIhvcNAQkEMSIEILhHwzG620dgtKUVD2SG0UW6Wf3aHAHBj9hrwoLIIAXPMEIG
# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v
# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEAY0qxFm5/R6xbe3C5
# hRy/e7c2+bIZ2Qqm77ElfotcuhiCGF+qsD9z4ZyT4j0lQV2twApTW5XiR0lGZ+lN
# XK2k8VgLPrn5BxpojcV4hB6Q5AuvR+KxuI9SJJVBMwqvi5AjeVBKXoKYP3Zv0KVi
# S1wMiUqW1vyBFUKYiaNOg7E9zM6x2RhT5uwo7FQISfDZ+EC+aMYQ0Z1dqT08khw6
# RAiU8MNLir6rSnhtHrwmOm9MFxhes5YNUtNkrGWbwrVQW4uH3ArXzzc4YOk1WevZ
# B716PgIhtM6aoNvsd/NHcO3hF6o+W5WfTfpW0HThSkhokam8bhAUXFqdH+o3qNBj
# SA9jaqGCF5YwgheSBgorBgEEAYI3AwMBMYIXgjCCF34GCSqGSIb3DQEHAqCCF28w
# ghdrAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFRBgsqhkiG9w0BCRABBKCCAUAEggE8
# MIIBOAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCC4O7of+0K1eBmN
# xnghd8fCGpidZKbuKRvPSBxzRGX35QIGarUmWRopGBIyMDI2MTAxMjE1Mzg0MC41
# M1owBIACAfSggdGkgc4wgcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y
# YXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAl
# BgNVBAsTHm5TaGllbGQgVFNTIEVTTjpBOTM1LTAzRTAtRDk0NzElMCMGA1UEAxMc
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEe0wggcgMIIFCKADAgECAhMz
# AAACJ9XAg8OxLlctAAEAAAInMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVT
# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l
# LVN0YW1wIFBDQSAyMDEwMB4XDTI2MDIxOTE5NDAwNFoXDTI3MDUxNzE5NDAwNFow
# gcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS
# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsT
# HE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQg
# VFNTIEVTTjpBOTM1LTAzRTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt
# U3RhbXAgU2VydmljZTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAOLF
# bLV8M5IviqPcDWlp3L56UgMvCcXdS4vMkg5bAYdwSCvHHC2fK+JQgOabHKVNSXW7
# 7asE+nbNPgHDBCG8ZomkTGq88uUMWVt+ZJ+Uojzp4Wqh+JnuPw1NE7iXvAaD02Ob
# 6a41q5NwVbap18iMoT3nQ6Sub0ycw4ZjL5+Js1h3FM9E+rVPgwtkreze90zIwQ6V
# 1w5CRIqnEPr/UaTqA6YK7YqAjx/R7Hq9jGcoOX1bQ4tIRr/rLzaghuyb7VAGJ85D
# jvFYpMbUKa+0avzkvMDvn8wBxSZHDn+h/+oRPRQVXVa6UxwmsjoMBICw0I0H7pYu
# ui24FkCP5UyWpuflExnpDghjsnBoCIheHtWPGufBQ5hkbxYQaF+sD3x2L7ssSf0C
# q+8Q7Ib5RByNWEIJswZeKAldICl7J5a6kKwPSOBAw0LF8HkEsENbGB1jd0kEQ+DF
# +SBMNAsGCC1W/Z3kJjEcqAgi0Hhsjl5JvmOQgbZai2cV61PSV6CnD8SjPB/f1qjq
# 0Q1jbV5VYjNHD8aya/CNhAXq9WvE4PSkZWx+oYXyzdU95juEjZPEcUyo0DQgH9rY
# 0tjslPFgAoA//XUQlm3vFuoMsyAPVgN0YTMalCKObecA8IvYJ5s/+Oa73RpsnZbj
# bnKCUYdMj+cIGvBKl9EKDDOt8V6UloIozr7floV/AgMBAAGjggFJMIIBRTAdBgNV
# HQ4EFgQU0tbnw3gwZIbq53uNaqBP3ait9F4wHwYDVR0jBBgwFoAUn6cVXQBeYl2D
# 9OXSZacbUzUZ6XIwXwYDVR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3Nv
# ZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUy
# MDIwMTAoMSkuY3JsMGwGCCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDov
# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1l
# LVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUB
# Af8EDDAKBggrBgEFBQcDCDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQAD
# ggIBACqdy53g9ILW15vYfqdG7LuwOIorXcVcmKtUHhN/CN2jYxv5AviPvBn+Tgb0
# /QIA0dkWsNBwrRUUNPKyti7xnQCFrXhpwNk+zIig+8AZFGFocS5/s1yRGOR9r/KW
# jUrIgjyNsv032wkCoE8vxXgU0GOWO/7UYcM7DXbutnPllJM+gA9vZIDS/nIOBylQ
# x/GCU/Knpyc8+hClO0P04bHwPCbY/6jVM/EEjLojRP1Fq66WiBUK8rB+V94tNwoC
# +dIbWsKN6tJeZTUM1c6wAP9uytKOBtfmYBsPtdNEwX+9rABYRIVyf8GOOLPF5Zlv
# TRphKWQkDatW0WUwzjzVpVZd0Btc8/lHNSJZOWDId/8buULEdhYYhm4HXdPdojpj
# yYSCf+i7jRqIUmjyvT6LQ/kZ02d5a3GJHQIwpR+Sj7mz/vdzB7VZ+nwEpdrbvRyJ
# xVBqwV/mxFXukWb5Xt81FfAK7tqdM6aBrvrM7v/a37M6WJu+mFP5Dpl34HapixKf
# jEFpj5jMemfJwtbly8nKE/EEJxvWhFh+FHMIANva60jYS0YKNzY/aKLgvJHhAxv+
# fxw7B4v0ipVMorPNWT7NknFXe+ungvK5BfDQ7fSVroFwd00AAAH1QLzfOzcb134C
# Uh9ksz3u0xQ0paNsGkiKsXHotMMVdW1lB3uGrMtgHKNuMfS6MIIHcTCCBVmgAwIB
# AgITMwAAABXF52ueAptJmQAAAAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UE
# BhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAc
# BgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0
# IFJvb3QgQ2VydGlmaWNhdGUgQXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1
# WhcNMzAwOTMwMTgzMjI1WjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu
# Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv
# cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCC
# AiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O
# 1YLT/e6cBwfSqWxOdcjKNVf2AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZn
# hUYjDLWNE893MsAQGOhgfWpSg0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t
# 1w/YJlN8OWECesSq/XJprx2rrPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxq
# D89d9P6OU8/W7IVWTe/dvI2k45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmP
# frVUj9z6BVWYbWg7mka97aSueik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSW
# rAFKu75xqRdbZ2De+JKRHh09/SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv
# 231fgLrbqn427DZM9ituqBJR6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zb
# r17C89XYcz1DTsEzOUyOArxCaC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYcten
# IPDC+hIK12NvDMk2ZItboKaDIV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQc
# xWv2XFJRXRLbJbqvUAV6bMURHXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17a
# j54WcmnGrnu3tz5q4i6tAgMBAAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQAB
# MCMGCSsGAQQBgjcVAgQWBBQqp1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQU
# n6cVXQBeYl2D9OXSZacbUzUZ6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEw
# QTA/BggrBgEFBQcCARYzaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9E
# b2NzL1JlcG9zaXRvcnkuaHRtMBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQB
# gjcUAgQMHgoAUwB1AGIAQwBBMAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/
# MB8GA1UdIwQYMBaAFNX2VsuP6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJ
# oEeGRWh0dHA6Ly9jcmwubWljcm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01p
# Y1Jvb0NlckF1dF8yMDEwLTA2LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYB
# BQUHMAKGPmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9v
# Q2VyQXV0XzIwMTAtMDYtMjMuY3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3h
# LB9nATEkW+Geckv8qW/qXBS2Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x
# 5MKP+2zRoZQYIu7pZmc6U03dmLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74p
# y27YP0h1AdkY3m2CDPVtI1TkeFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1A
# oL8ZthISEV09J+BAljis9/kpicO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbC
# HcNhcy4sa3tuPywJeBTpkbKpW99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB
# 9s7GdP32THJvEKt1MMU0sHrYUP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNt
# yo4JvbMBV0lUZNlz138eW0QBjloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3
# rsjoiV5PndLQTHa1V1QJsWkBRH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcV
# v7TOPqUxUYS8vwLBgqJ7Fx0ViY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A24
# 5oyZ1uEi6vAnQj0llOZ0dFtq0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lw
# Y1NNje6CbaUFEMFxBmoQtB1VM1izoXBm8qGCA1AwggI4AgEBMIH5oYHRpIHOMIHL
# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk
# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxN
# aWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRT
# UyBFU046QTkzNS0wM0UwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0
# YW1wIFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVACMfOq2E/A7QYNyQMwDrHniUiIwq
# oIGDMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
# BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm
# MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcN
# AQELBQACBQDud1zaMCIYDzIwMjYxMDEyMTMxOTIyWhgPMjAyNjEwMTMxMzE5MjJa
# MHcwPQYKKwYBBAGEWQoEATEvMC0wCgIFAO53XNoCAQAwCgIBAAICCX8CAf8wBwIB
# AAICExQwCgIFAO54rloCAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoD
# AqAKMAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAhcDa
# 6/GAx4GBBF86PwSDzjPGc0t/cgRzwPk8TqK5HHlmypj5J8cI1vOmT3AhCnSZ98Bl
# VuoQCaN4l3Jf/V6YdD4nD5aBDDmxexKE4rsDeL9DCIK6Za407tULUmmjdpWXQYuE
# LiFGi/2wghWKkvUZSfnxcxol9lZn3eFJu1UaqtGFmpKmLm/O2O/DLGneu3oNaxz0
# 8TNKn8k/kiyFfFu1yPfn6S886FiVWIZXQGZyT6rqQTghULdBL5nauKVvNUrshkIQ
# LABGvTD02HesaYLSJ99Jq8tBMykqJa6Ws6HYBDmuFnXuAvrN3Ie4HM5lMOvlDR+k
# 2sBSramcfG0sj3atazGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w
# IFBDQSAyMDEwAhMzAAACJ9XAg8OxLlctAAEAAAInMA0GCWCGSAFlAwQCAQUAoIIB
# SjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIP/H
# 2tOB56cQS8541hG9wTU8u0Pl39Ya6ii5lGlVXqUoMIH6BgsqhkiG9w0BCRACLzGB
# 6jCB5zCB5DCBvQQg5ecBGjWhUhw4skoOqUTRp2r+Nn1Nd2WddZFxcZOEEXIwgZgw
# gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD
# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAifVwIPDsS5X
# LQABAAACJzAiBCAckEkZPzvGttlqfBu9brbm1dz0JS4R23RSQBOrISJcVTANBgkq
# hkiG9w0BAQsFAASCAgAT656LjtcIFmtHn04XpBZXnBcPXnwuyorNHJKQ8hOoCTkg
# Nu74mLxX++TLHNO3SN1ofPRaxqRsN8GMYnM5/ZVhObyS3Aw+0uPxv1TSdZmMcgi2
# 9Df+haoHgNaW5ztx3acEiCm7vT7k4n8ugbdOubj8lpiDzzmlyS3RqO3/QmEZXKKf
# Gl/YeyzA463C/jrAxF97sgpRnlpAb+rO1pA1VpQtccdQkDgqaf9vBvH34GC/ogAX
# ubtCVYZY7X68kG9vHp6AvrkOg/z6rWc658+hqB21k6feIYQy/AX+A2nGODZ9hXY2
# mzJjViPmEOZqt5ZUjwXwhF6v2NokP6X7hZRcgIeAgUIWwFoU2KGqz6b2+9E/huns
# WNUqV5Hts3gK1vHyD9ZRWxfGboJOEVmKqdhFAVZxxEstik4EeGkii/RyUCHFMpYF
# 5ucEN4GMoBVKbTG4pmGqVAp0K9GVw4QkwDEVoVe1CwzJmZGKB9RC7+l5kn3W8wik
# xkEXCHSBpuISXnXBc1D0HYyt6FlHRSC60XdAJdZbEO0w+jFlIU9e/GxEMS79dZhN
# qoM1xCsGgszqiZVn0BqTynSduzFv8bbYocnwFRVwam2vFknsbDNcnABsAj9KOc7f
# 01xW7aO06MDMIqWGiiwIejIl4ZLY/qMCtVvHpDD0JpIqnEqLpsGhb/dioFjdcA==
# SIG # End signature block