Engines/Bicep/Get-AvmBicepScaffoldPlan.ps1

function Get-AvmBicepScaffoldPlan {
    [CmdletBinding()]
    [OutputType([pscustomobject[]])]
    param(
        [Parameter(Mandatory)]
        [string] $Path,

        [Parameter(Mandatory)]
        [System.Collections.IDictionary] $Metadata,

        [Parameter(Mandatory)]
        [ValidateSet('resource', 'pattern', 'utility')]
        [string] $ModuleType,

        [switch] $ChildModule
    )

    Set-StrictMode -Version 3.0
    $ErrorActionPreference = 'Stop'
    $pathInfo = Get-AvmBicepScaffoldPath -Path $Path -ModuleType $ModuleType -ChildModule:$ChildModule
    $root = $pathInfo.Path
    $kind = $pathInfo.Kind
    $group = $pathInfo.Group
    $moduleName = $pathInfo.ModuleName
    $modulePathSuffix = "$group/$moduleName"
    $initials = [System.Text.StringBuilder]::new()
    foreach ($segment in ("$group/$moduleName" -split '[-/]')) {
        if ($segment.Length -gt 0) {
            $null = $initials.Append($segment[0])
        }
    }
    $serviceInitials = $initials.ToString()

    $definitions = [System.Collections.Generic.List[object]]::new()
    $sourceTemplate = if ($ChildModule) { 'child.bicep' }
    elseif ($ModuleType -eq 'utility' -and -not $Metadata.Contains('telemetryIdPrefix')) { 'utility.bicep' }
    else { 'main.bicep' }
    $definitions.Add([pscustomobject]@{ Path = Join-Path $root 'main.bicep'; Template = $sourceTemplate; TestKind = $null })
    if (-not $ChildModule) {
        $definitions.Add([pscustomobject]@{ Path = Join-Path $root 'version.json'; Template = 'version.json'; TestKind = $null })
        $definitions.Add([pscustomobject]@{ Path = Join-Path $root 'CHANGELOG.md'; Template = 'CHANGELOG.md'; TestKind = $null })
        foreach ($testKind in @('defaults', 'waf-aligned')) {
            $testPath = Join-Path -Path $root -ChildPath 'tests' -AdditionalChildPath 'e2e', $testKind, 'main.test.bicep'
            $definitions.Add([pscustomobject]@{ Path = $testPath; Template = 'main.test.bicep'; TestKind = $testKind })
        }
    }

    $plans = [System.Collections.Generic.List[object]]::new()
    foreach ($definition in $definitions) {
        $parent = Split-Path -Path $definition.Path -Parent
        $leaf = Split-Path -Path $definition.Path -Leaf
        if (Test-Path -LiteralPath $parent -PathType Container) {
            $collisions = @(Get-ChildItem -LiteralPath $parent -Force | Where-Object { $_.Name -ieq $leaf })
            if ($collisions.Count -gt 0) {
                if ($collisions.Count -ne 1 -or $collisions[0].PSIsContainer -or $collisions[0].Name -cne $leaf) {
                    throw [System.ArgumentException]::new("Scaffold file must be a file with exact casing: $($definition.Path)")
                }
                if ($definition.Template -eq $sourceTemplate) {
                    $authoredSource = [System.IO.File]::ReadAllText($definition.Path)
                    $null = Get-AvmBicepMetadataLiteral -Source $authoredSource
                }
                continue
            }
        }
        elseif (Test-Path -LiteralPath $parent -PathType Leaf) {
            throw [System.ArgumentException]::new("Scaffold parent is a file: $parent")
        }

        $content = Get-AvmBicepScaffoldTemplate -Name $definition.Template
        switch ($definition.Template) {
            { $_ -in @('main.bicep', 'child.bicep', 'utility.bicep') } {
                foreach ($placeholder in @('<Add module name>', '<Add description>')) {
                    if (($content.Split([string[]]@($placeholder), [System.StringSplitOptions]::None)).Count -ne 2) {
                        throw [System.IO.InvalidDataException]::new(
                            "Bundled Bicep template has an invalid $placeholder placeholder: $($definition.Template)")
                    }
                }
                $content = $content.Replace('<Add module name>', (ConvertTo-AvmBicepStringValue -Value $Metadata.moduleDisplayName))
                $content = $content.Replace('<Add description>', (ConvertTo-AvmBicepStringValue -Value $Metadata.moduleDescription))
                $literals = Get-AvmBicepMetadataLiteral -Source $content
                if ($literals.name -cne $Metadata.moduleDisplayName -or $literals.description -cne $Metadata.moduleDescription) {
                    throw [System.IO.InvalidDataException]::new("Bundled Bicep template did not render valid metadata literals: $($definition.Template)")
                }
            }
            'version.json' {
                $version = ConvertFrom-Json -InputObject $content -AsHashtable -ErrorAction Stop
                if ([string]::IsNullOrWhiteSpace($version['$schema']) -or [string]::IsNullOrWhiteSpace($version.version)) {
                    throw [System.IO.InvalidDataException]::new('Bundled Bicep version.json template is invalid.')
                }
            }
            'CHANGELOG.md' {
                foreach ($placeholder in @('<moduleType>', '<modulePath>')) {
                    if (-not $content.Contains($placeholder)) {
                        throw [System.IO.InvalidDataException]::new(
                            "Bundled Bicep changelog template is missing $placeholder.")
                    }
                }
                $content = $content.Replace('<moduleType>', $kind).Replace('<modulePath>', $modulePathSuffix)
            }
            'main.test.bicep' {
                $name = if ($definition.TestKind -eq 'defaults') { 'Using only defaults' } else { 'WAF-aligned' }
                $description = if ($definition.TestKind -eq 'defaults') {
                    'This instance deploys the module with the minimum set of required parameters.'
                }
                else {
                    'This instance deploys the module in alignment with the best-practices of the Azure Well-Architected Framework.'
                }
                $replacements = [ordered]@{
                    '<TestName>'        = $name
                    '<TestDescription>' = $description
                    '<provider>'        = $group
                    '<resourceType>'    = $moduleName
                    '<serviceShort>'    = $serviceInitials + $(if ($definition.TestKind -eq 'defaults') { 'min' } else { 'waf' })
                }
                foreach ($placeholder in $replacements.Keys) {
                    if (-not $content.Contains($placeholder)) {
                        throw [System.IO.InvalidDataException]::new(
                            "Bundled Bicep test template is missing $placeholder.")
                    }
                    $content = $content.Replace($placeholder, $replacements[$placeholder])
                }
                $literals = Get-AvmBicepMetadataLiteral -Source $content
                if ($literals.name -cne $name -or $literals.description -cne $description) {
                    throw [System.IO.InvalidDataException]::new('Bundled Bicep test template did not render valid metadata literals.')
                }
            }
        }
        $plans.Add([pscustomobject]@{ Path = $definition.Path; Content = $content; Original = $null })
    }
    return $plans.ToArray()
}

# SIG # Begin signature block
# MIInUwYJKoZIhvcNAQcCoIInRDCCJ0ACAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCyw1mUqTg2sl3p
# u7aw9RB+5DbUUIlyGmcyaZUSdu/+pKCCDMkwggYEMIID7KADAgECAhMzAAACHPrN
# 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/AUmQN5W4n101cY2L4A7GTQG1h32HHAvfQESWP0xghngMIIZ3AIBATBu
# MFcxCzAJBgNVBAYTAlVTMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# KDAmBgNVBAMTH01pY3Jvc29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIc
# +s3Fm+gvfsQAAAAAAhwwDQYJYIZIAWUDBAIBBQCggZAwGQYJKoZIhvcNAQkDMQwG
# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIGvCrLv8SQWiS9N7s6gZEUZemnKi
# XvsLs912Mztgdul7MEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv
# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE
# ggEAhYs1PHwUEG2eg38cEMygYRXBpoHPuyCPceKOrKVroLXy31GGHzPxJaq0rYVd
# +jTeGI2q7JZ3+62aHUzDRkP0NpFE5C8bDW+gwY5WwUAEvQnu3O/z1FaAeoAW8tTn
# 2c5IMZhg325oja/yxGBXIPpIH5YFbofoAMPmLLJFCDBMNsD/fSy+vGVyzJyDqWl0
# bO6DsjOzlMi2+2/+NWbDD6PQ1knCbxGfXW92+8VImAD9vH9BgwWLGK8owUr9SAd4
# Lh7dHEPQLUsDlAtd+VQQElUHvtzPYwGXQT20vdKstoI6WbBSzszbOE7Rp8gD/Qx3
# LXvWV+9pZKj7AnTpZTCMfNnVIqGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gG
# CSqGSIb3DQEHAqCCF4kwgheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG
# 9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC
# AQUABCBZK8HTJK0jVg6PIsxOr5t5ADpo9Hsa/ApmobNsC9vpnwIGavNrJKFwGBMy
# MDI2MTExOTE2MjUyMy42ODJaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzET
# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
# TWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFu
# ZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1
# NTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy
# dmljZaCCEf4wggcoMIIFEKADAgECAhMzAAACMD8HBDPE+znWAAEAAAIwMA0GCSqG
# SIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw
# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x
# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI2MTAx
# NTE4MzczNVoXDTI4MDExMTE4MzczNVowgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQI
# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv
# ZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh
# dGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjU1MUEtMDVF
# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIC
# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEA1cEQVtstXsck0ADRFt9EV4LZ
# G44m5xoRjTIHfdKjXBeh22TDpVY5NvxQBdQuIgcf/aeXwnQop/membLFvCsLxEgK
# 3Yz2RXe/7DRO1IR7d85oFNqqb/uEqVPtPR5kaopbbfwm8meA8B6dRNEzSevc5CO5
# kJ8Z7YBWiwMtsqVIIzpWYotsmgbsYasFgVSWHu4NMFHOj5J2KW8d2vO7YwAGr2JS
# vZ3M9FimfT/4rDyvl+JzDMQ+ud/Qun6mMe4nX4OeP6CFQOutNB5W0BBxQOxgcFaW
# mV/ZDwDzk3s2BPhuw7y8E9Pk8EtKvUL24SG8J2uShrJ1+sDaJJIwXCSauQVydT/I
# zdXk1d2U1rtdS/mjJR1EiKCfAUfcuswSZdlqhbJO2DG2hU6b9+JD3C3ndKJOzQuC
# lIXPXAcXMJ1q3BLHvHRAyTzk9dI1+isryfgtf+Ai/tfJGIxpTYRFRUZv3UuxtRkb
# Y/f1dTJjtkgBYqqZAWXh7zmeAGOD+hopnWF3n2YBQaB++vwW15PgIs31PqlyYjhI
# yzZsWGR9/UHm0GWT1uFwcOohQ1amSf6KTiWbKM2GJJWPlV89OS4L2nGlTmmc6kBO
# QR5l7n6oB5tH/q/SA4j6htrx6ofVaOXl3engKmq1h30Dkj9kr66chuqV+OOWjK3U
# NZsymIvRCIZKLMNVCHkCAwEAAaOCAUkwggFFMB0GA1UdDgQWBBTiqGFDQRnAqqVR
# JAjMxZuO23GwBTAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNV
# HR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2Ny
# bC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYI
# KwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j
# b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAy
# MDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMI
# MA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAAdh3Fu8eRSaaR7qC
# 4Zd/DX+PAyhQUAV6/giVCUGlkpxu0qJ8cQvrd+gDQ0xlZssBuPqwiHv9N8YV1DF8
# s4s4jn2oI1Sv9Tw6jOnqqQux6GVfd9P0vSCU1R2dn8FnQkDjDa4VifGPCw+K7s4y
# utEWL5CDwWI4w5TJR76YVS386EZoO+r4Abdo4EBcCNMGxei7CUp5wzMEK1X+lr5h
# /yNMeigLnxsCT4NiySCXZ9xRCBRniaeHlLL0VwjdUyK1TbZYOnB2Gfly8ILL+AYb
# eYXVJuilNV5ToQcJzrXrU3a7eO+PnkMtcetAHskjDlJMga6ZbnB4kvwl4ZVDx9gY
# k+iArYhTGS9jd45Md8DdXhNA/Ep2vT8HexrieDz2fh6JM3h/UFaBPvcVH+sCWPPp
# KKzX9TGlPfPamYO+cjykuHfD/eryV8MZGtJ/5o+lfdMZf4mHzRF4q5U+JR6NiNau
# Gi6+pAoRgMVnuSdC1X8wZEXHqeqx6h82GNn/m7J0O35UnXkBfNXat22oCr9RRmzL
# u+OKscbKa/Jfc+EeLKHXgfj4s+MDVEP4bQUFODN22SAVVP7YCmmwDoX8+u7wevaG
# EFeDbh+n5O6FIRoGOxScT96C0SvhtdMMyzD9dDnJtuDZYyXWU+i0qFQR3WHwsd1N
# 84ESx5QU8OstdLQau0SppGMY88AwggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZ
# AAAAAAAVMA0GCSqGSIb3DQEBCwUAMIGIMQswCQYDVQQGEwJVUzETMBEGA1UECBMK
# V2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0
# IENvcnBvcmF0aW9uMTIwMAYDVQQDEylNaWNyb3NvZnQgUm9vdCBDZXJ0aWZpY2F0
# ZSBBdXRob3JpdHkgMjAxMDAeFw0yMTA5MzAxODIyMjVaFw0zMDA5MzAxODMyMjVa
# MHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS
# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMT
# HU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMIICIjANBgkqhkiG9w0BAQEF
# AAOCAg8AMIICCgKCAgEA5OGmTOe0ciELeaLL1yR5vQ7VgtP97pwHB9KpbE51yMo1
# V/YBf2xK4OK9uT4XYDP/XE/HZveVU3Fa4n5KWv64NmeFRiMMtY0Tz3cywBAY6GB9
# alKDRLemjkZrBxTzxXb1hlDcwUTIcVxRMTegCjhuje3XD9gmU3w5YQJ6xKr9cmmv
# Haus9ja+NSZk2pg7uhp7M62AW36MEBydUv626GIl3GoPz130/o5Tz9bshVZN7928
# jaTjkY+yOSxRnOlwaQ3KNi1wjjHINSi947SHJMPgyY9+tVSP3PoFVZhtaDuaRr3t
# pK56KTesy+uDRedGbsoy1cCGMFxPLOJiss254o2I5JasAUq7vnGpF1tnYN74kpEe
# HT39IM9zfUGaRnXNxF803RKJ1v2lIH1+/NmeRd+2ci/bfV+AutuqfjbsNkz2K26o
# ElHovwUDo9Fzpk03dJQcNIIP8BDyt0cY7afomXw/TNuvXsLz1dhzPUNOwTM5TI4C
# vEJoLhDqhFFG4tG9ahhaYQFzymeiXtcodgLiMxhy16cg8ML6EgrXY28MyTZki1ug
# poMhXV8wdJGUlNi5UPkLiWHzNgY1GIRH29wb0f2y1BzFa/ZcUlFdEtsluq9QBXps
# xREdcu+N+VLEhReTwDwV2xo3xwgVGD94q0W29R6HXtqPnhZyacaue7e3PmriLq0C
# AwEAAaOCAd0wggHZMBIGCSsGAQQBgjcVAQQFAgMBAAEwIwYJKwYBBAGCNxUCBBYE
# FCqnUv5kxJq+gpE8RjUpzxD/LwTuMB0GA1UdDgQWBBSfpxVdAF5iXYP05dJlpxtT
# NRnpcjBcBgNVHSAEVTBTMFEGDCsGAQQBgjdMg30BATBBMD8GCCsGAQUFBwIBFjNo
# dHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL0RvY3MvUmVwb3NpdG9yeS5o
# dG0wEwYDVR0lBAwwCgYIKwYBBQUHAwgwGQYJKwYBBAGCNxQCBAweCgBTAHUAYgBD
# AEEwCwYDVR0PBAQDAgGGMA8GA1UdEwEB/wQFMAMBAf8wHwYDVR0jBBgwFoAU1fZW
# y4/oolxiaNE9lJBb186aGMQwVgYDVR0fBE8wTTBLoEmgR4ZFaHR0cDovL2NybC5t
# aWNyb3NvZnQuY29tL3BraS9jcmwvcHJvZHVjdHMvTWljUm9vQ2VyQXV0XzIwMTAt
# MDYtMjMuY3JsMFoGCCsGAQUFBwEBBE4wTDBKBggrBgEFBQcwAoY+aHR0cDovL3d3
# dy5taWNyb3NvZnQuY29tL3BraS9jZXJ0cy9NaWNSb29DZXJBdXRfMjAxMC0wNi0y
# My5jcnQwDQYJKoZIhvcNAQELBQADggIBAJ1VffwqreEsH2cBMSRb4Z5yS/ypb+pc
# FLY+TkdkeLEGk5c9MTO1OdfCcTY/2mRsfNB1OW27DzHkwo/7bNGhlBgi7ulmZzpT
# Td2YurYeeNg2LpypglYAA7AFvonoaeC6Ce5732pvvinLbtg/SHUB2RjebYIM9W0j
# VOR4U3UkV7ndn/OOPcbzaN9l9qRWqveVtihVJ9AkvUCgvxm2EhIRXT0n4ECWOKz3
# +SmJw7wXsFSFQrP8DJ6LGYnn8AtqgcKBGUIZUnWKNsIdw2FzLixre24/LAl4FOmR
# sqlb30mjdAy87JGA0j3mSj5mO0+7hvoyGtmW9I/2kQH2zsZ0/fZMcm8Qq3UwxTSw
# ethQ/gpY3UA8x1RtnWN0SCyxTkctwRQEcb9k+SS+c23Kjgm9swFXSVRk2XPXfx5b
# RAGOWhmRaw2fpCjcZxkoJLo4S5pu+yFUa2pFEUep8beuyOiJXk+d0tBMdrVXVAmx
# aQFEfnyhYWxz/gq77EFmPWn9y8FBSX5+k77L+DvktxW/tM4+pTFRhLy/AsGConsX
# HRWJjXD+57XQKBqJC4822rpM+Zv/Cuk0+CQ1ZyvgDbjmjJnW4SLq8CdCPSWU5nR0
# W2rRnj7tfqAxM328y+l7vzhwRNGQ8cirOoo6CGJ/2XBjU02N7oJtpQUQwXEGahC0
# HVUzWLOhcGbyoYIDWTCCAkECAQEwggEBoYHZpIHWMIHTMQswCQYDVQQGEwJVUzET
# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV
# TWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFu
# ZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo1
# NTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy
# dmljZaIjCgEBMAcGBSsOAwIaAxUAp7M4L4fH9llHoq6sJyqTIY6+wT6ggYMwgYCk
# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH
# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD
# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIF
# AO6pHTowIhgPMjAyNjExMTkwNzAxMTRaGA8yMDI2MTEyMDA3MDExNFowdzA9Bgor
# BgEEAYRZCgQBMS8wLTAKAgUA7qkdOgIBADAKAgEAAgIQwgIB/zAHAgEAAgIb+TAK
# AgUA7qpuugIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB
# AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUAA4IBAQAeaXTTFVHI50JN
# Aal8JthuSthr3fH5lF2D9nvH7pSNwwkdM5eokt9g4JtfzhApVc1tmRLg6ALF+A7y
# GIcrovZChtzpvyhY/VQwbYMzxq2/GRkXIGCvxr/WwVLFyYpqeLOIeXoZo3xg6gIH
# 0OFRbQbjJ7t2o31DhvSBodvdPchl7OV/r6BWyTvlHZ4hBzbmEJobfVaHM8XGSfKh
# cjXUZQRJrWe1qEd2NLigzyR2twd2vRA/bAS00rzsSo0CjoLqsQTR3cp4tC7INvzD
# g94tu7A0wEj2LE9DLbJYK6mAcCUTLC0xKTTUhH6/3CM+x4xhSFMby50wrUKzYj+0
# bz6WAjguMYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh
# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD
# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw
# MTACEzMAAAIwPwcEM8T7OdYAAQAAAjAwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqG
# SIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQgiJd5vkIciskl
# hXoswVkUtKXMxUsEKSAMO25Ab8h3PX8wgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHk
# MIG9BCAUkli670WWz4FWuHPGaXjpzlNyR2AbvTse3KmiAh/RaDCBmDCBgKR+MHwx
# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt
# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p
# Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACMD8HBDPE+znWAAEAAAIw
# MCIEIPZ2v1D2m1/BoXUZ9RR1njwKUrZS7vvlEdgcafQcsGWaMA0GCSqGSIb3DQEB
# CwUABIICAAyeUDD9/pUPxap7z5uh4/Rxb8gYzgWXnPQCOsI7APc8K4QOHrG7b5gg
# TlFDB+CPdmtDMfm0vAzAwHLqKVTRrAxOKTxc/pDNn+Cbv6EQFqU0l9M7bprPIOvx
# 0krvCDubPD+PX8xs656ux++feANdx4u8A15+W/LMpollTpNWSCAQe1go3Rzuw/d3
# iP0X1zwPvZ0TMSRpRm8y+2XztDIWtEeZP6T004QL2MDOXULG3Vi5LS1iUPvcwLGw
# vetQLs/IDX0VjmgngZK4MKmgNpdok6imZq/FPA4lAAVbH5grbyKdpPnf5LMkmxX0
# CKgsd7xxq6guut7dID9LSduPd69F5yDLLjax11tib5uV6fGmupnAtBARVYUIGqol
# vCs11Fzwl4SiwU5CMLQoLFek5VKSWdLr4+oheTuexiGC7fH5KKJJiXwdpK4l4UUY
# InKbM88POsT2Jga1ibIOZH/FKE76tIst5a9efN0Ge5tChRM53Y0nYa3s8UXqE7o9
# bD6en2t6Lav883wc97M6ptYxN6pt/RhrTX9urbgvBAleu358GNpq2ktRuw/VPc4X
# tWRXQHLcvuE9RBy4XvXUTXaKAYlqSgALxnR6DeBUMeAeBK6+7owpsac0iepLUcl8
# qlbOYusIEtsk2lsePQ3LXayAxs+3dUeSyuYAW8HsRZvCxwjaB762
# SIG # End signature block