Resources/bicep/conventions/Workflow.Tests.ps1

#Requires -Version 7.4
[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseDeclaredVarsMoreThanAssignments', 'environment', Justification = 'Pester BeforeAll shares this value with It blocks.')]
[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseDeclaredVarsMoreThanAssignments', 'inputs', Justification = 'Pester BeforeAll shares this value with It blocks.')]
[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseDeclaredVarsMoreThanAssignments', 'paths', Justification = 'Pester BeforeAll shares this value with It blocks.')]
[Diagnostics.CodeAnalysis.SuppressMessageAttribute('PSUseDeclaredVarsMoreThanAssignments', 'expectedPaths', Justification = 'Pester BeforeAll shares this value with It blocks.')]
param(
    [Parameter(Mandatory)]
    [System.Collections.IDictionary] $Convention
)

$cases = @($Convention.Workflows | ForEach-Object {
        @{ Scope = $_.Scope; WorkflowInput = $_.Input; Label = $_.Scope.ModuleRelativePath; IssuePath = $_.Input.Path; IssueRoot = $_.Scope.RepositoryRoot }
    })
$Convention.NativeWorkflowExpected = 0

Describe 'Bicep workflow: <Label>' -ForEach $cases {
    $Convention.NativeWorkflowExpected++
    $inputCode = if ($WorkflowInput.Issues.Count -gt 0) { $WorkflowInput.Issues[0].Code } else { 'avm.bicep.workflow-file' }
    It 'loads a regular, exact-case workflow as YAML' -Tag $inputCode {
        @($WorkflowInput.Issues) | Should -HaveCount 0 -Because (@($WorkflowInput.Issues | ForEach-Object Message) -join '; ')
        $WorkflowInput.Workflow | Should -BeOfType ([System.Collections.IDictionary])
    }
    if ($WorkflowInput.Issues.Count -eq 0 -and $WorkflowInput.Workflow -is [System.Collections.IDictionary]) {
        $Convention.NativeWorkflowExpected += 19
        BeforeAll {
            $workflow = $WorkflowInput.Workflow
            $environment = if ($workflow['env'] -is [System.Collections.IDictionary]) { $workflow['env'] } else { @{} }
            $events = if ($workflow['on'] -is [System.Collections.IDictionary]) { $workflow['on'] } else { @{} }
            $dispatch = if ($events['workflow_dispatch'] -is [System.Collections.IDictionary]) { $events['workflow_dispatch'] } else { @{} }
            $inputs = if ($dispatch['inputs'] -is [System.Collections.IDictionary]) { $dispatch['inputs'] } else { @{} }
            $push = if ($events['push'] -is [System.Collections.IDictionary]) { $events['push'] } else { @{} }
            $paths = @(if ($push.Contains('paths')) { $push['paths'] })
            $expectedPaths = @(".github/workflows/$($WorkflowInput.FileName)", "$($Scope.ModuleRelativePath)/**", '!*/**/README.md', '!avm/**/metadata.json')
        }
        It 'declares env.<Name>' -ForEach @(@{ Name = 'workflowPath' }, @{ Name = 'modulePath' }) -Tag 'avm.bicep.workflow-env' {
            $environment.Contains($Name) | Should -BeTrue
        }
        It 'sets the canonical workflow path' -Tag 'avm.bicep.workflow-path' {
            $environment['workflowPath'] | Should -BeOfType ([string])
            $environment['workflowPath'] | Should -BeExactly ".github/workflows/$($WorkflowInput.FileName)"
        }
        It 'sets the canonical module path' -Tag 'avm.bicep.workflow-module-path' {
            $environment['modulePath'] | Should -BeOfType ([string])
            $environment['modulePath'] | Should -BeExactly $Scope.ModuleRelativePath
        }
        It 'permits only manual and push triggers' -Tag 'avm.bicep.workflow-trigger' {
            @($events.psbase.Keys | Where-Object { $_ -cnotin @('workflow_dispatch', 'push') }) | Should -HaveCount 0
        }
        It 'declares dispatch input <Name>' -ForEach @(
            @{ Name = 'customLocation' }, @{ Name = 'staticValidation' },
            @{ Name = 'deploymentValidation' }, @{ Name = 'removeDeployment' }
        ) -Tag 'avm.bicep.workflow-dispatch' {
            $inputs[$Name] | Should -BeOfType ([System.Collections.IDictionary])
        }
        It 'enables static validation by default' -Tag 'avm.bicep.workflow-staticValidation-default' {
            $inputs['staticValidation'] | Should -BeOfType ([System.Collections.IDictionary])
            $inputs['staticValidation']['default'] | Should -BeOfType ([bool])
            $inputs['staticValidation']['default'] | Should -BeTrue
        }
        It 'enables deployment validation by default' -Tag 'avm.bicep.workflow-deploymentValidation-default' {
            $inputs['deploymentValidation'] | Should -BeOfType ([System.Collections.IDictionary])
            $inputs['deploymentValidation']['default'] | Should -BeOfType ([bool])
            $inputs['deploymentValidation']['default'] | Should -BeTrue
        }
        It 'does not default the custom location' -Tag 'avm.bicep.workflow-custom-location' {
            $inputs['customLocation'] | Should -BeOfType ([System.Collections.IDictionary])
            $inputs['customLocation'].Contains('default') | Should -BeFalse
        }
        It 'limits push options to branches and paths' -Tag 'avm.bicep.workflow-push-options' {
            @($push.psbase.Keys | Where-Object { $_ -cnotin @('branches', 'paths') }) | Should -HaveCount 0
        }
        It 'runs automatically only on main' -Tag 'avm.bicep.workflow-push-branches' {
            $branches = @(if ($push.Contains('branches')) { $push['branches'] })
            @($branches) | Should -HaveCount 1
            $branches[0] | Should -BeOfType ([string])
            $branches[0] | Should -BeExactly 'main'
        }
        It 'includes every canonical push filter' -Tag 'avm.bicep.workflow-push-paths-missing' {
            @($expectedPaths | Where-Object { $paths -cnotcontains $_ }) | Should -HaveCount 0
        }
        It 'has exactly four canonical push filters' -Tag 'avm.bicep.workflow-push-paths-excess' {
            @($paths) | Should -HaveCount 4
            @($paths | Where-Object { $_ -isnot [string] -or $_ -cnotin $expectedPaths }) | Should -HaveCount 0
            @($paths | Select-Object -Unique) | Should -HaveCount 4
        }
        It 'excludes metadata after all positive filters' -Tag 'avm.bicep.workflow-push-metadata-last' {
            @($paths) | Should -Not -BeNullOrEmpty
            $paths[-1] | Should -BeExactly '!avm/**/metadata.json'
        }
        It 'orders push filters canonically' -Tag 'avm.bicep.workflow-push-paths-order' {
            @($paths) | Should -HaveCount 4
            for ($index = 0; $index -lt 4; $index++) {
                $paths[$index] | Should -BeExactly $expectedPaths[$index]
            }
        }
        It 'guards initialization against cancellation and automatic fork runs' -Tag 'avm.bicep.workflow-condition' {
            $workflow['jobs'] | Should -BeOfType ([System.Collections.IDictionary])
            $workflow['jobs']['job_initialize_pipeline'] | Should -BeOfType ([System.Collections.IDictionary])
            $condition = $workflow['jobs']['job_initialize_pipeline']['if']
            $condition | Should -BeOfType ([string])
            $expression = $condition.Trim()
            if ($expression.StartsWith('${{', [System.StringComparison]::Ordinal) -and
                $expression.EndsWith('}}', [System.StringComparison]::Ordinal)) {
                $expression = $expression.Substring(3, $expression.Length - 5).Trim()
            }
            $expression | Should -MatchExactly "^\s*!cancelled\(\)\s*&&\s*!\(\s*github\.repository\s*!=\s*'Azure/bicep-registry-modules'\s*&&\s*github\.event_name\s*!=\s*'workflow_dispatch'\s*\)\s*$"
        }
    }
}

# SIG # Begin signature block
# MIInKgYJKoZIhvcNAQcCoIInGzCCJxcCAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCBBrnBcz5wwVbpM
# nSqzUP46KPtvWJMKHGcaC2jcEcLkVqCCDLowggX1MIID3aADAgECAhMzAAACHU0Z
# 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
# KoZIhvcNAQkEMSIEIK2xCzS3MMTHVOugTp1Vwl4wLAvR2x4cEmZr9cBNGjdRMEIG
# CisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8v
# d3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAEggEATGQIj/GWJDp2Hri4
# 2FmRjAXF7BlpJ3lB+5HUOjLxK4Wa1ECEsKHZLauHJsaDyDRQq5far5l1xVAchg0N
# edmc84cL4qZZzIMfLXgRAOpTpa8LT3WEs4aIA7kH/uhqcVYgPU5dVzPhNQJBNvEo
# EhKPBpphJTEhZb/4bRBD9ExV2zF+JLDUZgeDz9Hnxl7pWehF13oNxSZv3/DQ/qbN
# cvG32BwXrvfmnTtLpOxD/JG0kqs8TRUZfa0yc8ilYnv90jc38OXuRHYg+oiBFy8M
# ZSNHBsxcm8omADrpKtNctLC00REpZ/4D6Hi4bxxHy+lB3iWE3RzIWoqdRusEXgJs
# 5H5DDaGCF5YwgheSBgorBgEEAYI3AwMBMYIXgjCCF34GCSqGSIb3DQEHAqCCF28w
# ghdrAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFRBgsqhkiG9w0BCRABBKCCAUAEggE8
# MIIBOAIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQCAQUABCCGynj+CXwBRalT
# aJ+2PAoDExObHfyjeNQPVFoTW4d//AIGaqk5622+GBIyMDI2MTAxNTEzNDUyOS4w
# N1owBIACAfSggdGkgc4wgcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5n
# dG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9y
# YXRpb24xJTAjBgNVBAsTHE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAl
# BgNVBAsTHm5TaGllbGQgVFNTIEVTTjpBNDAwLTA1RTAtRDk0NzElMCMGA1UEAxMc
# TWljcm9zb2Z0IFRpbWUtU3RhbXAgU2VydmljZaCCEe0wggcgMIIFCKADAgECAhMz
# AAACKPClh9fzyB5AAAEAAAIoMA0GCSqGSIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVT
# MRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQK
# ExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1l
# LVN0YW1wIFBDQSAyMDEwMB4XDTI2MDIxOTE5NDAwNloXDTI3MDUxNzE5NDAwNlow
# gcsxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdS
# ZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJTAjBgNVBAsT
# HE1pY3Jvc29mdCBBbWVyaWNhIE9wZXJhdGlvbnMxJzAlBgNVBAsTHm5TaGllbGQg
# VFNTIEVTTjpBNDAwLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUt
# U3RhbXAgU2VydmljZTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK6O
# 9uT+ypwJJF5lol8K5/U3BFxzteSeETrCQuh+Q2PWbEQCDfmrLbFwWOCNqu1W8DT1
# bxAdynIypVJc5PE0cmyaTSo/YIMu9QC6VaDtpLmgE5GkRfWjPefRHac+p4fQgcrX
# MnGPFodbbUBu5nRn7AzdZg3OQGVweZV7TdkbuuWTbyHvavk/kwTwUakWZhbkeXum
# wpuAsR+tgCK2m22xv6xmwFQj6EwqXi4slii0rJm/V7A4iKcF9FTxCiyK+Oh9oF7N
# R/011X6IataHfbVadKwrcD8mXoYu1tJZdwlZQuBvG6qehs8r5iUHfXvhMxZOBfhh
# aMbujQ63P+mMc0IoFsHvzx3KeEt0ZjoHTwT37hIatGmy3LiIkc7J0cIDkziLnJhH
# Cx2636Ca/EilPzI1clyMkKDS87ya/+cVj1bK2/aqYK0IUWK8ZRapTbT+xR5GihBk
# aJA4lCfT3kKPeKwiy9E/wpTuE38QMjwdWxv80/MwUu9HOetGePRM6cOI5NRydjCa
# T5d+hLWjCyRwIILAedsLTQPnzPzfLsrlkkHvjmFyfgITadHd7pEayvjbLmq23ox3
# P+zsxOcNLZSZUdZfVf8dl7dSVfyCP+3rcvnTEg+qREIER0zUAM1RpJ+j05CIpv9u
# PV2JkIZN8QNQEEuinWaGTAgXzZ9qmVXZu6xn5TiRAgMBAAGjggFJMIIBRTAdBgNV
# HQ4EFgQUqsmljPjy3Oi69WQFW2EBIWlD3cMwHwYDVR0jBBgwFoAUn6cVXQBeYl2D
# 9OXSZacbUzUZ6XIwXwYDVR0fBFgwVjBUoFKgUIZOaHR0cDovL3d3dy5taWNyb3Nv
# ZnQuY29tL3BraW9wcy9jcmwvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUy
# MDIwMTAoMSkuY3JsMGwGCCsGAQUFBwEBBGAwXjBcBggrBgEFBQcwAoZQaHR0cDov
# L3d3dy5taWNyb3NvZnQuY29tL3BraW9wcy9jZXJ0cy9NaWNyb3NvZnQlMjBUaW1l
# LVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcnQwDAYDVR0TAQH/BAIwADAWBgNVHSUB
# Af8EDDAKBggrBgEFBQcDCDAOBgNVHQ8BAf8EBAMCB4AwDQYJKoZIhvcNAQELBQAD
# ggIBAJDo18uatFqGBW2BaDfzcZpLTt8fKh3puFxQ423a1637oFo24fSvsAGRUeF4
# 6nEF2tSs4RhURoiKL10rdy5ks2anWJQDH9VuY5liXvHP602uMJaquDWNCarShEHy
# IThAmnA2EY/ruhjmG5ghTQPiWEOhqGp+Aomf/QGT71QoM/DleVRiat4WYmWP1hDN
# w896nwzEFfGH9jkju9B5FpblKO2ItA4tGTeCC+toOzlJ/j0wlXr8HDFcLau9R8QV
# fpJQOiioogT02BUhGrRFm7s63SLQiz4e88/SEHorA7EyDVJYo59O0Wlal2jwwm+A
# oIeQ+lcTOCms/6nIge47uBVGVJOxtgEUuHbIh3+K0zi5gvRH7ZJIEFOlJJG2Gsa4
# SYSUjkEIczHMyD+iodI/BkAgCQzYLjHGLRK3uoy4D6b5nMViR+gXjVChImf4eOqG
# pZhDSb9I738qclEklTAx3lOIyeNn4T8MmJSvLm52JbJCm9+PaFAUjR2OFqGgBcNr
# N4RyIsXa4SdO6v1R+NzA66f+gxj5Qt+2c6LaMosyut5XT3tqTPP8nGmcOBglT+2B
# Tt9B+WDsiqIv37Tbvr6OhAejbWZV5jlgPwqH+RRpjomb85Mzzwbt69PP+qdG6bGi
# 9OMxK2+lsAc1GGZJN0g9NXfYLK7EMpL9XlrmLAD5/1WIGj7CMIIHcTCCBVmgAwIB
# 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
# UyBFU046QTQwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0
# YW1wIFNlcnZpY2WiIwoBATAHBgUrDgMCGgMVAHWtuYWTNLuoArU5q/TwBSeFs0hS
# oIGDMIGApH4wfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAO
# BgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEm
# MCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwDQYJKoZIhvcN
# AQELBQACBQDue0CPMCIYDzIwMjYxMDE1MTIwNzQzWhgPMjAyNjEwMTYxMjA3NDNa
# MHcwPQYKKwYBBAGEWQoEATEvMC0wCgIFAO57QI8CAQAwCgIBAAICBw8CAf8wBwIB
# AAICEp0wCgIFAO58kg8CAQAwNgYKKwYBBAGEWQoEAjEoMCYwDAYKKwYBBAGEWQoD
# AqAKMAgCAQACAwehIKEKMAgCAQACAwGGoDANBgkqhkiG9w0BAQsFAAOCAQEAF5GW
# LxfIXrDnLU4obcSTtJKmKnNgearDIuRdd7eL5sFaXyQUfRuIPVPjfrctUden9llY
# QByHFmZKbzGSlE6ATtyJ/R7z++dxQ/SYFrEqArHCn15tkhRrXG/2M5DbLcyKmqWk
# JOUcmi2MjQ8TSwjlN2Sh9XO8wtrszms6aQFAkMG0/Ul0C94Rp7GT58Zl7IMQk/V8
# 3MVlPvULcTu999CY9YwPGFLwgdgaZUX0rnb/UuNRICDeuFTTGJ91doTcMyt+Mj2N
# Gj5yoK6MkYtkpzRgGVahE+dJP3bTbtM98/lNBF17mFi05nYtUIQfO5USKLckGHV2
# SSLXadiRPgEYmP9FqjGCBA0wggQJAgEBMIGTMHwxCzAJBgNVBAYTAlVTMRMwEQYD
# VQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNy
# b3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1w
# IFBDQSAyMDEwAhMzAAACKPClh9fzyB5AAAEAAAIoMA0GCWCGSAFlAwQCAQUAoIIB
# SjAaBgkqhkiG9w0BCQMxDQYLKoZIhvcNAQkQAQQwLwYJKoZIhvcNAQkEMSIEINw0
# fhyMW08TNcfLEjZl1hf1pNcrF68ay9sA//sVsdDsMIH6BgsqhkiG9w0BCRACLzGB
# 6jCB5zCB5DCBvQQgVbGKRlFgY1/igRVkrV5Pjkf7cZDf+rFXvlXC4G36ItcwgZgw
# gYCkfjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UE
# BxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYD
# VQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAijwpYfX88ge
# QAABAAACKDAiBCBy0iyKzGw4LqVOk+gGf3Gt6VTQMpKzjgB7tL5h53UlujANBgkq
# hkiG9w0BAQsFAASCAgBa0yb5HNbXnjlURapJhw1UY87eP8BQ6iU0y8ERwNjgbMqO
# 71crH0udGfVNnoiBHvJGnTQAQH5byXWMsKWugJZriOy4N3kNBDMKZfVSVsbKuGSF
# JpZfZ0AW4qQdqr1ijVyjV1q6byq59yFg2zBR7XifQjgmqX3JqTwk0MHWdOyVvamm
# ailGgWZg2E+DyYDjq5aR1HX1AOYk1hspg666szhr4CsjQ6iWzlMXaypW87VJOlFM
# yAL8pKKksffVCMfrdE9cdBLySzqk/DuR45d4XCJ4zI0aNEy7u6BQu41ieK5sJ0EY
# yL3zkgEm1/qu2FS2bESuM7nXsXUp4ZsmUE4XSXMLNNYCK/2vX131twTxgVvxDsIA
# aRyowekHov5YT4GNYKSlyX5DF8LgPAEx/qMBnUC9XyQcCh2rBZeN0LdzgUhAfCKk
# 34a2SNL+lB6LtOfKZ3+1sYwunzK5e2pdqPQmje9NHNMHIe/YmMC8pHf5rPQJqc5H
# 5Gt/VtYNn3BOuT/Dds49vOVchMT5JivP7W/i5ICgJdmyBxnEubNZlrFLo1d8lvtB
# tBsPYwOzWNLrru7eTjoupn30KUOPC/F3FqoKZg3aUlCBs0gav0CAq2Tg5XvfuVeO
# D8COjyNfj3qzqkc9Fg6yn2Iok0V15eLF1pGZs7d7tDi3IXpY4xXj2Fnc7iFpaw==
# SIG # End signature block