Avm.Authoring

0.10.1

Private/Context/Read-AvmContextOverride.ps1

                                function Read-AvmContextOverride {

    <#

    .SYNOPSIS

        Parse a committed .avm/context.psd1 override at a context root.

    .DESCRIPTION

        Inspects only $Path for a .avm/context.psd1 file. When found, parses

        it as a PowerShell data file and validates the contents against the

        ModuleContext schema. Returns a pscustomobject in the same shape as

        Get-AvmModuleContextInternal would produce, or $null when no

        override file exists.

        The override file lets a repository declare its classification

        explicitly when direct source detection would misclassify the layout

        or be ambiguous.

        Schema (all fields optional except Ecosystem and Kind):

            @{

                Ecosystem = 'bicep'                # bicep | terraform

                Kind      = 'bicep-monorepo'       # bicep-monorepo | bicep-module |

                                                   # terraform-module-repo | terraform-module-path

                Scope     = 'res'                  # res | ptn | utl (bicep only)

                Owner     = '@Azure/avm-core'      # optional

            }

        $Path is used as the Root.

    #>

    [CmdletBinding()]

    [OutputType([pscustomobject])]

    param(

        [Parameter(Mandatory)] [string] $Path

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    $validEcosystems = @('bicep', 'terraform')

    $validKinds = @('bicep-monorepo', 'bicep-module', 'terraform-module-repo', 'terraform-module-path')

    $validScopes = @('res', 'ptn', 'utl')

    $overridePath = Join-Path (Join-Path $Path '.avm') 'context.psd1'

    if (-not (Test-Path -LiteralPath $overridePath -PathType Leaf)) {

        return $null

    }

    $data = Import-PowerShellDataFile -LiteralPath $overridePath

    if (-not $data.ContainsKey('Ecosystem')) {

        throw [AvmConfigurationException]::new(

            "${overridePath}: missing required key 'Ecosystem'.")

    }

    if (-not $data.ContainsKey('Kind')) {

        throw [AvmConfigurationException]::new(

            "${overridePath}: missing required key 'Kind'.")

    }

    if ($data.Ecosystem -notin $validEcosystems) {

        throw [AvmConfigurationException]::new(

            "${overridePath}: Ecosystem '$($data.Ecosystem)' is not one of: $($validEcosystems -join ', ').")

    }

    if ($data.Kind -notin $validKinds) {

        throw [AvmConfigurationException]::new(

            "${overridePath}: Kind '$($data.Kind)' is not one of: $($validKinds -join ', ').")

    }

    if ($data.ContainsKey('Scope') -and $null -ne $data.Scope -and $data.Scope -notin $validScopes) {

        throw [AvmConfigurationException]::new(

            "${overridePath}: Scope '$($data.Scope)' is not one of: $($validScopes -join ', ').")

    }

    return [pscustomobject][ordered]@{

        Kind      = [string]$data.Kind

        Root      = $Path

        Ecosystem = [string]$data.Ecosystem

        Scope     = if ($data.ContainsKey('Scope')) { $data.Scope } else { $null }

        Owner     = if ($data.ContainsKey('Owner')) { $data.Owner } else { $null }

    }

}

# SIG # Begin signature block

# MIInUQYJKoZIhvcNAQcCoIInQjCCJz4CAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDpQSZ6WSXQsWan

# GoMyC/vac2wjI8KuN3nJtX9/5VWiJ6CCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# xZvoL37EAAAAAAIcMA0GCSqGSIb3DQEBCwUAMFcxCzAJBgNVBAYTAlVTMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jvc29mdCBD

# b2RlIFNpZ25pbmcgUENBIDIwMjQwHhcNMjYwNDE2MTg1OTQxWhcNMjcwNDE1MTg1

# OTQxWjB0MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE

# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMR4wHAYD

# VQQDExVNaWNyb3NvZnQgQ29ycG9yYXRpb24wggEiMA0GCSqGSIb3DQEBAQUAA4IB

# DwAwggEKAoIBAQDVsZfgOKmM31HPfoWOoNEiw0SlCiIxUMC0I9NMWbucKOw/e9lP

# oAoehQVu6SG65V4EPzrYsnBnFPNoi4/HoOdjhz1qkrEt4I6tEcxXU6oOeY9zGveC

# /3iBeuhLYxM3M/PkcUoebF+Nednm8OkdSPoDu8imViHPQq/8CQUu0WRR4rE+dMRf

# rpVqfmNi2qWCX94T4MsepijGVkwE//tJg0ryAiYdHT34LSnlG/RSBZmQRGWZ5g8j

# qnKjRParSqMft1gvjuUTVgtWNZfgcLFSK5Wa0myrq8OPcgTGGsRgun+tnSS+IxDT

# xVsAPH1OzvPjwomguByhUe/OcvUN0D5Wmp7xAgMBAAGjggGqMIIBpjAOBgNVHQ8B

# Af8EBAMCB4AwHwYDVR0lBBgwFgYKKwYBBAGCN0wIAQYIKwYBBQUHAwMwHQYDVR0O

# BBYEFNoH7a2YDjOSwpkp6DHcmUS7J+0yMFQGA1UdEQRNMEukSTBHMS0wKwYDVQQL

# EyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRpb25zIExpbWl0ZWQxFjAUBgNVBAUT

# DTIzMDAxMis1MDc1NjkwHwYDVR0jBBgwFoAUf1k/VCHarU/vBeXmo9ctBpQSCDEw

# YAYDVR0fBFkwVzBVoFOgUYZPaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9w

# cy9jcmwvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmclMjBQQ0ElMjAyMDI0LmNy

# bDBtBggrBgEFBQcBAQRhMF8wXQYIKwYBBQUHMAKGUWh0dHA6Ly93d3cubWljcm9z

# b2Z0LmNvbS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwQ29kZSUyMFNpZ25pbmcl

# MjBQQ0ElMjAyMDI0LmNydDAMBgNVHRMBAf8EAjAAMA0GCSqGSIb3DQEBCwUAA4IC

# AQAUnEqhaRXe0T3hIJjvdQErEkrA/7bByjn6t5IArODkkRjzkYwtKMc2yYj2quaN

# rLutWw2YZcngKPy1b71YyDJQTy4NDRwaSh9Tw5thrk3NmcPrAHia5vtcBJ1CgtKK

# 7mQbIcQ22d/N3813ayCDDFewu1+jsZmX+r/aTEqaOM4TVxVtRSkuCy8nAXKuChOK

# Li/zA4XuH8iEYqIsj2YoNaeSxVmeGiERXpKdo3dDmYi0kO5w2D8VS4c3+9h6gElY

# BaAAg/dYErBg27qT3vv0zRDJhJufvCNylA8S7/+8H5E/PV5cng6na9VV/w9OV3qu

# uND6zdGa2EX38Glp50F9AIQk3p2xXmcvorDeM4XJ7UlWYBi6g80J1SSOQnInCYFE

# msfUNn3+1AaTJKSJL83quKArTac2pKhu0Yzzzrzo6HrsRiQKzpnRBb1/dMa6P3hz

# 75XbMRBctNsFhZC07WCmjExdLg2eHW5uV0TY8D5+6wozJf7vF3+WHkYPO85Z+BC6

# U4FkNbYNycZ9cE4j1tXRdyDCfml6c0HWPHjNVDObrv9lKt3qUqFpX38VCqVCyNOO

# 1UcXfQiVjJw32U2WUKZjt/neJKHEBsm9kFsLuWzkQ53+qcaSaytmsCnk2gOglrlD

# 5d3kKyvvAw+rzm0lT8K38P6PLxfZQHhu4W8dV7Av8N2ZmDCCBr0wggSloAMCAQIC

# EzMAAAA5O7Y3Gb8GHWcAAAAAADkwDQYJKoZIhvcNAQEMBQAwgYgxCzAJBgNVBAYT

# AlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYD

# VQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBS

# b290IENlcnRpZmljYXRlIEF1dGhvcml0eSAyMDExMB4XDTI0MDgwODIwNTQxOFoX

# DTM2MDMyMjIyMTMwNFowVzELMAkGA1UEBhMCVVMxHjAcBgNVBAoTFU1pY3Jvc29m

# dCBDb3Jwb3JhdGlvbjEoMCYGA1UEAxMfTWljcm9zb2Z0IENvZGUgU2lnbmluZyBQ

# Q0EgMjAyNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBANgBnB7jOMeq

# lRYHNa265v4IY9fH8TKhemHfPINe1gpLaV3dhg324WwH06LcHbpnsBukCDNitryo

# 0dtS/EW6I/yEL/bLSY8hKpbfQuWusBPr9qazYcDxCW/qnjb5JsI1s8bNOg3bVATv

# QVL4tcf03aTycsz8QeCdM0l/yHRObJ9QqazM1r6VPEOJ7LL+uEEb73w6QCuhs89a

# 1uv1zerOYMnsneRRwCbpyW11IcggU0cRKDDq1pjVJzIbIF6+oiXXbReOsgeI8zu1

# FyQfK0fVkaya8SmVHQ/tOf23mZ4W9k0Ri22QW9p3UgSC5OUDktKxxcCmGL6tXLfO

# GSWHIIV4YrTJTT6PNty5REojHJuZHArkF9VnHTERWoTjAzfI3kP+5b4alUdhgAZ7

# ttOu1bVnXfHaqPYl2rPs20ji03LOVWsh/radgE17es5hL+t6lV0eVHrVhsssROWJ

# uz2MXMCt7iw7lFPG9LXKGjsmonn2gotGdHIuEg5JnJMJVmixd5LRlkmgYRZKzhxS

# CwyoGIq0PhaA7Y+VPct5pCHkijcIIDm0nlkK+0KyepolcqGm0T/GYQRMhHJlGOOm

# VQop36wUVUYklUy++vDWeEgEo4s7hxN6mIbf2MSIQ/iIfMZgJxC69oukMUXCrOC3

# SkE/xIkgpfl22MM1itkZ35nNXkMolU1lAgMBAAGjggFOMIIBSjAOBgNVHQ8BAf8E

# BAMCAYYwEAYJKwYBBAGCNxUBBAMCAQAwHQYDVR0OBBYEFH9ZP1Qh2q1P7wXl5qPX

# LQaUEggxMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBBMA8GA1UdEwEB/wQFMAMB

# Af8wHwYDVR0jBBgwFoAUci06AjGQQ7kUBU7h6qfHMdEjiTQwWgYDVR0fBFMwUTBP

# oE2gS4ZJaHR0cDovL2NybC5taWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNybDBeBggrBgEFBQcBAQRSMFAw

# TgYIKwYBBQUHMAKGQmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2kvY2VydHMv

# TWljUm9vQ2VyQXV0MjAxMV8yMDExXzAzXzIyLmNydDANBgkqhkiG9w0BAQwFAAOC

# AgEAFJQfOChP7onn6fLIMKrSlN1WYKwDFgAddymOUO3FrM8d7B/W/iQ6DxXsDn7D

# 5W4wMwYeLystcEqfkjz4NURRgazyMu5yRzQh4LqjA4tStTcJh1opExo7nn5PuPBY

# nbu0+THSuVHTe0VTTPVhily/piFrDo3axQ9P4C+Ol5yet+2gTfekICS5xS+cYfSI

# vgn0JksVBVMYVI5QFu/qhnLhsEFEUzG8fvv0hjgkO+lkpV9ty6GkN4vdnd7ya6Q6

# aR9y34aiM1qmxaxBi6OUnyNl6fkuun/diTFnYDLTppOkr/mg5WSfCiDVMNCxtj4w

# PKC5OmHm1DQIt/MNokbbH3UGsFP1QbzsLocuSqLCvH09Io3fDPTmscR9Y75G4qX7

# RTX8AdBPo0I6OEojf39zuFZt0qOHm65YWQE69cZM2ueE1MB05dNNgHK9gTE7zKvK

# /fg8B2qjW88MT/WF5V5uvZGtqa9FSL2RazArA+rDPuf6JGYz4HpgMZHB4S6szWSK

# YBv0VisCzfxgeU+dquXW9bd0auYlOB58DPcOYKdc3Se94g+xL4pcEhbB54JOgAkw

# YTu/9dLeH2pDqeJZAABVDWRQCaXfO5LgyKwKCLYXpigrZYCjUSBcr+Ve8PFWMhVT

# Ql0v4q8J/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghneMIIZ2gIBATBu

# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc

# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG

# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEICnfevBhGdcutadWPvvuGhsoZh9+

# pk3KttP1G8FEhuzOMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv

# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE

# ggEAh65pC//9WwW6tkvAyiqqV04NghONDm5s6JAGpXRmWayDsNJ9mD8yeIwWay1Z

# VTW5Oegky2rzteLe3bxa5EOKHJvgbgs+aAy01Gw64guwp0B2bSM8mW0afYhlzaA2

# 6bVut4t1TQyJVGHs9PgZL5AhdzmH9WtRVPbhd6Zs3TwH07d55RWQDc/21kvtBX0R

# I31ScVS3JDFCDbKbi57jq9CAS9XB52xegGRtxD6cxIg5RL2pHDSB3qH5jKTgEbJ3

# uYJF8IGivKjJlkq6yGtIgoMkp6aY15gt7iQS0rGRtI2QBjtT/ZEi+WhrLT1W5CZI

# NIGPKEaGRE7PQKmMpqN7MSopXqGCF64wgheqBgorBgEEAYI3AwMBMYIXmjCCF5YG

# CSqGSIb3DQEHAqCCF4cwgheDAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFYBgsqhkiG

# 9w0BCRABBKCCAUcEggFDMIIBPwIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC

# AQUABCAeHuA98zYJzrC+vL6ZYRt3hdBWiCeq3/I/iTmc4aFXpgIGamOc1U/2GBEy

# MDI2MDgyMDIzMjgxNy44WjAEgAIB9KCB2aSB1jCB0zELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQg

# T3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NDMx

# QS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp

# Y2WgghH+MIIHKDCCBRCgAwIBAgITMwAAAh1LwJKHOIV+OQABAAACHTANBgkqhkiG

# 9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4G

# A1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYw

# JAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAeFw0yNTA4MTQx

# ODQ4MzNaFw0yNjExMTMxODQ4MzNaMIHTMQswCQYDVQQGEwJVUzETMBEGA1UECBMK

# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0

# IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFuZCBPcGVyYXRp

# b25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo0MzFBLTA1RTAt

# RDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZTCCAiIw

# DQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAKK0oGgAPKDpeKYee+M8NvXoFDfA

# w3qURy1/BTNcxzSZlxuiq0qlCsM3Cmn6KbmHT0xE0wr2/WiXxErgFNIhjVBSPw+k

# dJL3X6XtqD1/hN7G00LxouCTx+anSGFGieOVf+G6nvHjb21s6QvmSox9fdw3oiNV

# wCPdfCaEJgYZRF6P06J9e9tZbmSYIp3LH+S4zGN41/OFsl1El93bEu4f+8VSPsNc

# o4O6WvtMt6P5ntk7L+lCVHUk0GqeTkRknwp3JZz9c9yIoliFq91aO2iD1rICc6t5

# uRsacVBwkJPKs1IZOdMv7gfixhN1iCtgu+4svYhbEn0i1J8jBMxkQ1vZlx0+Dx+z

# s8+gh6kBIjb8HB6pb5QodaR0IdTV0EgKjqFQbOZounmrH+ssVk33uQ60e/edN6/K

# VOlagtmPVzEVOMB/UG2F2LCFGd9yZp3cttltSwQwG8QT0BwgZZ3Bg1NwYHYVVFS3

# vNJoIBTvfBXZFoaOu8OJD3Qk0ZL3b5GPD60GBP50Ix1wmtIOy3DLbWW+nozB30Pr

# VFl7+vp2eGJ5K9jpGsXJRQsOESGDTFg9ugFm0I/1hHc4GtfHyrcOui+YM1z82uox

# QXzyXihNx/EALsKYq5h+JrPuZ1IzTUDpjYKiZ9FNft2J+wpbMA+/WDdK933W2ATA

# wKQWSaTZSu6ux10bAgMBAAGjggFJMIIBRTAdBgNVHQ4EFgQUhFnwcTRGpmbV5vIJ

# fdmKvNI38V0wHwYDVR0jBBgwFoAUn6cVXQBeYl2D9OXSZacbUzUZ6XIwXwYDVR0f

# BFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jcmwv

# TWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIwMTAoMSkuY3JsMGwGCCsG

# AQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDovL3d3dy5taWNyb3NvZnQuY29t

# L3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAx

# MCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUBAf8EDDAKBggrBgEFBQcDCDAO

# BgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQADggIBAJHcHgeMsby7KSyqtA/p

# osg+ENBHMVRaTWbicYkeeIFkZHkww7spjXgdNyYZbAaW8EmCebmUoAwQr8BxA9lS

# /JSaRZTqayc8bF1gtjU3wPjvjzuRZOY8Oix4eo3gQAwxHUAMdx6ou2ZtCcL0Pd8+

# X+nbcZJtvVqjnB2F0V3wEMMtYUqy18n3m5akeuo6T//Z9HwpFlOIILFI0KUNjYI9

# Q1dPSeGN8u6fTXfNfl7OqmKPvu0SpvKogf+TQ3ooDi45QHhYIhFyEVCVvpicqqUM

# PjjkZWqnBY0fB7tBvv+2zHXpOvGF/pD6QwZO1HviP8YImCdcXA0QZ/73My7Te9vk

# SJQ+FIF2C7gUgpP/6QxD1+c9/Qq/q5HOhOGNvBT5OAYZaAMr6etvD+MXxJUGPE3M

# a2lG2UocqaHBOp8veQ9StQZJbWZqx1SgsZoJZ7jpTNeTSiK1xZVws3aqQrSMEONe

# 8DQFRf0Az78827pj3U4un29LS20nGKG1es72wbDLChDBOE49W/aCFwvHcmyauJ22

# 6BF2KUcItUAG6Uja5/j8Rlvbn9autxZzCbuIJtzoet541v4lX+9t6rs8h60oo1jI

# GNB4kYh0ItCcrtIfDHYUVKe5sW5i0HJD4jhcAJSGlDf5O9ucv2i1qZEVOn6pi5RD

# sh+Vqci3dtwGMva/L/kKG2urMIIHcTCCBVmgAwIBAgITMwAAABXF52ueAptJmQAA

# AAAAFTANBgkqhkiG9w0BAQsFADCBiDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEyMDAGA1UEAxMpTWljcm9zb2Z0IFJvb3QgQ2VydGlmaWNhdGUg

# QXV0aG9yaXR5IDIwMTAwHhcNMjEwOTMwMTgyMjI1WhcNMzAwOTMwMTgzMjI1WjB8

# MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk

# bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1N

# aWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDCCAiIwDQYJKoZIhvcNAQEBBQAD

# ggIPADCCAgoCggIBAOThpkzntHIhC3miy9ckeb0O1YLT/e6cBwfSqWxOdcjKNVf2

# AX9sSuDivbk+F2Az/1xPx2b3lVNxWuJ+Slr+uDZnhUYjDLWNE893MsAQGOhgfWpS

# g0S3po5GawcU88V29YZQ3MFEyHFcUTE3oAo4bo3t1w/YJlN8OWECesSq/XJprx2r

# rPY2vjUmZNqYO7oaezOtgFt+jBAcnVL+tuhiJdxqD89d9P6OU8/W7IVWTe/dvI2k

# 45GPsjksUZzpcGkNyjYtcI4xyDUoveO0hyTD4MmPfrVUj9z6BVWYbWg7mka97aSu

# eik3rMvrg0XnRm7KMtXAhjBcTyziYrLNueKNiOSWrAFKu75xqRdbZ2De+JKRHh09

# /SDPc31BmkZ1zcRfNN0Sidb9pSB9fvzZnkXftnIv231fgLrbqn427DZM9ituqBJR

# 6L8FA6PRc6ZNN3SUHDSCD/AQ8rdHGO2n6Jl8P0zbr17C89XYcz1DTsEzOUyOArxC

# aC4Q6oRRRuLRvWoYWmEBc8pnol7XKHYC4jMYctenIPDC+hIK12NvDMk2ZItboKaD

# IV1fMHSRlJTYuVD5C4lh8zYGNRiER9vcG9H9stQcxWv2XFJRXRLbJbqvUAV6bMUR

# HXLvjflSxIUXk8A8FdsaN8cIFRg/eKtFtvUeh17aj54WcmnGrnu3tz5q4i6tAgMB

# AAGjggHdMIIB2TASBgkrBgEEAYI3FQEEBQIDAQABMCMGCSsGAQQBgjcVAgQWBBQq

# p1L+ZMSavoKRPEY1Kc8Q/y8E7jAdBgNVHQ4EFgQUn6cVXQBeYl2D9OXSZacbUzUZ

# 6XIwXAYDVR0gBFUwUzBRBgwrBgEEAYI3TIN9AQEwQTA/BggrBgEFBQcCARYzaHR0

# cDovL3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9Eb2NzL1JlcG9zaXRvcnkuaHRt

# MBMGA1UdJQQMMAoGCCsGAQUFBwMIMBkGCSsGAQQBgjcUAgQMHgoAUwB1AGIAQwBB

# MAsGA1UdDwQEAwIBhjAPBgNVHRMBAf8EBTADAQH/MB8GA1UdIwQYMBaAFNX2VsuP

# 6KJcYmjRPZSQW9fOmhjEMFYGA1UdHwRPME0wS6BJoEeGRWh0dHA6Ly9jcmwubWlj

# cm9zb2Z0LmNvbS9wa2kvY3JsL3Byb2R1Y3RzL01pY1Jvb0NlckF1dF8yMDEwLTA2

# LTIzLmNybDBaBggrBgEFBQcBAQROMEwwSgYIKwYBBQUHMAKGPmh0dHA6Ly93d3cu

# bWljcm9zb2Z0LmNvbS9wa2kvY2VydHMvTWljUm9vQ2VyQXV0XzIwMTAtMDYtMjMu

# Y3J0MA0GCSqGSIb3DQEBCwUAA4ICAQCdVX38Kq3hLB9nATEkW+Geckv8qW/qXBS2

# Pk5HZHixBpOXPTEztTnXwnE2P9pkbHzQdTltuw8x5MKP+2zRoZQYIu7pZmc6U03d

# mLq2HnjYNi6cqYJWAAOwBb6J6Gngugnue99qb74py27YP0h1AdkY3m2CDPVtI1Tk

# eFN1JFe53Z/zjj3G82jfZfakVqr3lbYoVSfQJL1AoL8ZthISEV09J+BAljis9/kp

# icO8F7BUhUKz/AyeixmJ5/ALaoHCgRlCGVJ1ijbCHcNhcy4sa3tuPywJeBTpkbKp

# W99Jo3QMvOyRgNI95ko+ZjtPu4b6MhrZlvSP9pEB9s7GdP32THJvEKt1MMU0sHrY

# UP4KWN1APMdUbZ1jdEgssU5HLcEUBHG/ZPkkvnNtyo4JvbMBV0lUZNlz138eW0QB

# jloZkWsNn6Qo3GcZKCS6OEuabvshVGtqRRFHqfG3rsjoiV5PndLQTHa1V1QJsWkB

# RH58oWFsc/4Ku+xBZj1p/cvBQUl+fpO+y/g75LcVv7TOPqUxUYS8vwLBgqJ7Fx0V

# iY1w/ue10CgaiQuPNtq6TPmb/wrpNPgkNWcr4A245oyZ1uEi6vAnQj0llOZ0dFtq

# 0Z4+7X6gMTN9vMvpe784cETRkPHIqzqKOghif9lwY1NNje6CbaUFEMFxBmoQtB1V

# M1izoXBm8qGCA1kwggJBAgEBMIIBAaGB2aSB1jCB0zELMAkGA1UEBhMCVVMxEzAR

# BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p

# Y3Jvc29mdCBDb3Jwb3JhdGlvbjEtMCsGA1UECxMkTWljcm9zb2Z0IElyZWxhbmQg

# T3BlcmF0aW9ucyBMaW1pdGVkMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046NDMx

# QS0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZp

# Y2WiIwoBATAHBgUrDgMCGgMVALqDvgSm3186sn4vRixHVh5Ai3k/oIGDMIGApH4w

# fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl

# ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd

# TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcNAQELBQACBQDu

# MbEPMCIYDzIwMjYwODIwMTY1OTU5WhgPMjAyNjA4MjExNjU5NTlaMHcwPQYKKwYB

# BAGEWQoEATEvMC0wCgIFAO4xsQ8CAQAwCgIBAAICN7ACAf8wBwIBAAICE3IwCgIF

# AO4zAo8CAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoDAqAKMAgCAQAC

# AwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEASnBpW94+KIRDbFmO

# bPnkhdvv9gr6vtFXefQe2tDjiicnlBtBSRCFNcYkA8eCwcCFaFwZZ4g79jQRJC5m

# OAHeOT4Zqsypqus0NnrctrM3PLwhhEA+BAn9hvQBLKpWKQ1H+f2LK+7HX255J5m+

# VQojqGlsckMKgtPQyrPpXoSuA8lkuvMLNsO7+tYuvhnO42XjWxDmTgq1NjJRYdiH

# vEulaC2EfaFxAP13yGCb/AADdrHDsa7aUsjo/s781NlWooE5dXRj3A/O/T0GiDdY

# +Orv4aZLdjCSVQvazAGSmhGkIQ+VAbPTQ9FQl38V0lEGvmB7GkzYnqDJ30s4WxlF

# ooeT1DGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNo

# aW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29y

# cG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEw

# AhMzAAACHUvAkoc4hX45AAEAAAIdMA0GCWCGSAFlAwQCAQUAoIIBSjAaBgkqhkiG

# 9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEIOrnw5Amd11yZP0h

# 1+aQ5oNWL3nqV9aHwYI/7i5LcBF+MIH6BgsqhkiG9w0BCRACLzGB6jCB5zCB5DCB

# vQQgsbaVzFxIiyc66jO+3qeK0zcKzDo+oKVjfYWb6Y+UBVEwgZgwgYCkfjB8MQsw

# CQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9u

# ZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQDEx1NaWNy

# b3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAh1LwJKHOIV+OQABAAACHTAi

# BCAukqvp6CCCq2y0asGhOS0aFj5u5C3IAACTS54rxjk0rTANBgkqhkiG9w0BAQsF

# AASCAgBKCD3fYlUxlzDcCRhQ42Ju57yaPqOfTXwgQdDrMdJEiZxo+JdfudoPpBMJ

# cuEHI+QWqvitc3TG1ZkmEB4o5raqR8XB1oaLvG/m4cqx/LT9YGSwLGM/iQZvYsto

# TPRd9AbJetw6/LWxE20rYkPnUkY6w8NL/4kJFyLpJ3DilxRDmlIyJrsmbloI8ZZk

# RJsnUf70sn1dQ5ZXHOcnxSG2Zqwf2s/7mtDRL2bi2f6tpJw/RWcZzyLXgUVGfjOF

# 8ibYX1ny5gCfHEWAABWTXLZ4aW524Tq2OMKkUZOOLeuk0iq0iQpM4EhlX9otaNdZ

# YZnsR9HQdTyowsKrDwOQw7NXChPhYPmbQMYR+I5qtgHXnURh8giaD9L2n1RrltDu

# DCEt63BPnV/Nz7DcUapuxiJx7dZIBJH6ZkequDDMSPatVhoQ9tEyn1pfdnG3zrKB

# vrh5bjHXBI6C8HeRWwD4/kaFRfewZfUQ3AHbbjV19iXvrSiOk6pz9E+gzD454o3o

# mCSt3EUWiyFCsy3pSBzTda8IR3eSbq7ScsTDJJRjftrniAUAlhGALbnGmt95pObI

# AbeAlzLb8coylQb7aQ3J11dazObkaBX6rlY6RuMQ1DmMUSdrol+CXufFSS3Gtqp0

# xmYf7MzPUj2Yw3iPVFqTXfmHRPg5q/oYVK3kksHJhwb91mycPA==

# SIG # End signature block