Avm.Authoring

0.20.0

Engines/Terraform/Publish-AvmTerraformRepositoryContent.ps1

                                function Publish-AvmTerraformRepositoryContent {

    <#

    .SYNOPSIS

        Publish the first commit of a Terraform module repository from a clean staging checkout.

    .DESCRIPTION

        Clones the repository's main branch into a temporary directory, adds

        metadata.json and the packaged minimal scaffold, and runs avm

        pre-commit to add the current managed files, telemetry, and README.

        Nothing else from the caller's directory is published, and main must

        hold only the files the open source portal seeds. Organization rulesets

        require pull requests on main, so the push runs with

        global-rulesets-opt-out temporarily set to true. The original value is

        recorded in the user's state folder first and restored afterwards; a

        failed restore is retried by the next avm init run. A value that is

        already true stops the publication because its original value is

        unknown, and a repository that repository sync manages is refused

        because its own ruleset requires a pull request. Returns Status

        'pass', 'planned', 'blocked' (main has other content), or 'fail'

        (avm pre-commit failed).

    .PARAMETER Repository

        Repository as owner/name.

    .PARAMETER RepositoryId

        The repository's GitHub ID, stored in the opt-out record.

    .PARAMETER MetadataPath

        Validated metadata.json to publish unchanged.

    .PARAMETER Metadata

        The validated metadata values, used to render the scaffold.

    #>

    [CmdletBinding(SupportsShouldProcess, ConfirmImpact = 'Medium')]

    [OutputType([pscustomobject])]

    param(

        [Parameter(Mandatory)]

        [string] $Repository,

        [Parameter(Mandatory)]

        [long] $RepositoryId,

        [Parameter(Mandatory)]

        [string] $MetadataPath,

        [Parameter(Mandatory)]

        [System.Collections.IDictionary] $Metadata

    )

    Set-StrictMode -Version 3.0

    $ErrorActionPreference = 'Stop'

    $result = { param($Status, $Commit, $PreCommit, $Files) [pscustomobject]@{ Status = $Status; Commit = $Commit; PreCommit = $PreCommit; Files = @($Files) } }

    if (-not $PSCmdlet.ShouldProcess($Repository, 'Publish the initial module commit to main')) {

        return (& $result 'planned' $null $null @())

    }

    # The steps below are parts of this confirmed operation and work in a temporary clone.

    $ConfirmPreference = 'None'

    $recordPath = Get-AvmRulesetOptOutRecordPath -Repository $Repository

    if (Test-Path -LiteralPath $recordPath) {

        throw [System.InvalidOperationException]::new(

            "An earlier global-rulesets-opt-out change on $Repository has not been restored. Run avm init again.")

    }

    if (Test-AvmRepositorySyncManaged -Repository $Repository) {

        throw [AvmConfigurationException]::new(

            "Repository sync already protects main on $Repository, so avm init cannot push the first commit. " +

            'Add metadata.json and the module files with a pull request, then run avm init again.')

    }

    $staging = Join-Path -Path (Get-AvmFolder -Kind Temp) -ChildPath ('avm-init-' + [guid]::NewGuid().ToString('N').Substring(0, 8))

    $checkout = Join-Path -Path $staging -ChildPath ($Repository -split '/')[-1]

    $null = New-Item -ItemType Directory -Path $staging

    try {

        $null = Invoke-AvmGit -ArgumentList @('clone', '--quiet', "https://github.com/$Repository.git", $checkout) `

            -WorkingDirectory $staging -UseGitHubCredential

        $git = @{ WorkingDirectory = $checkout }

        if ((Invoke-AvmGit @git -ArgumentList @('rev-parse', '--verify', '--quiet', 'refs/remotes/origin/main') -IgnoreExitCode).ExitCode -eq 0) {

            $null = Invoke-AvmGit @git -ArgumentList @('checkout', '--quiet', '-B', 'main', 'origin/main')

        }

        else {

            $null = Invoke-AvmGit @git -ArgumentList @('symbolic-ref', 'HEAD', 'refs/heads/main')

        }

        $seedFiles = @('README.md', 'LICENSE', 'SECURITY.md', 'SUPPORT.md', 'CODE_OF_CONDUCT.md', '.gitignore')

        $unexpected = @((Invoke-AvmGit @git -ArgumentList @('ls-files')).StdOut -split '\r?\n' |

                Where-Object { $_ -and $_ -cnotin $seedFiles })

        if ($unexpected.Count -gt 0) {

            return (& $result 'blocked' $null $null $unexpected)

        }

        Copy-Item -LiteralPath $MetadataPath -Destination (Join-Path -Path $checkout -ChildPath 'metadata.json')

        $plans = @(Get-AvmTerraformScaffoldPlan -Path $checkout -Metadata $Metadata)

        if ($plans.Count -gt 0) {

            $null = Write-AvmModuleInitializationPlan -Root $checkout -Plan $plans -Confirm:$false

        }

        $preCommit = Invoke-AvmPreCommit -Path $checkout -Ecosystem terraform

        if ([string]$preCommit.Status -in @('fail', 'error')) {

            return (& $result 'fail' $null $preCommit @())

        }

        $null = Invoke-AvmGit @git -ArgumentList @('add', '--all')

        $null = Invoke-AvmGit @git -ArgumentList @('add', '--force', '--', 'metadata.json')

        if ((Invoke-AvmGit @git -ArgumentList @('var', 'GIT_COMMITTER_IDENT') -IgnoreExitCode).ExitCode -ne 0) {

            throw [AvmConfigurationException]::new(

                'Configure a Git commit identity with git config --global user.name and user.email, then run avm init again.')

        }

        $null = Invoke-AvmGit @git -ArgumentList @('commit', '--quiet', '--message', 'chore: initialize module repository')

        $original = Get-AvmRepositoryRulesetOptOut -Repository $Repository

        if ($original -ceq 'true') {

            throw [AvmConfigurationException]::new(

                "global-rulesets-opt-out is already true on $Repository, so its original value is unknown. " +

                'Set the property back to its original value, normally false, then run avm init again.')

        }

        $null = New-Item -ItemType Directory -Path (Split-Path -Path $recordPath -Parent) -Force

        $record = [ordered]@{

            repository   = $Repository

            repositoryId = $RepositoryId

            propertyName = 'global-rulesets-opt-out'

            value        = $original

        }

        [System.IO.File]::WriteAllText($recordPath, (ConvertTo-Json -InputObject $record).Replace("`r`n", "`n") + "`n",

            [System.Text.UTF8Encoding]::new($false))

        Set-AvmRepositoryRulesetOptOut -Repository $Repository -Value 'true' -Confirm:$false

        $pushError = $null

        try {

            $null = Invoke-AvmGit @git -ArgumentList @('push', '--quiet', 'origin', 'HEAD:refs/heads/main') -UseGitHubCredential

        }

        catch {

            $pushError = $_

        }

        finally {

            try {

                Set-AvmRepositoryRulesetOptOut -Repository $Repository -Value $original -Confirm:$false

                Remove-Item -LiteralPath $recordPath -Force

            }

            catch {

                $failures = @($_.Exception)

                if ($null -ne $pushError) {

                    $failures = @($pushError.Exception) + $failures

                }

                $restore = if ($null -eq $original) { 'unset' } else { $original }

                throw [System.AggregateException]::new(

                    "Could not restore global-rulesets-opt-out to $restore on $Repository. Run avm init again to restore it.",

                    [System.Exception[]]$failures)

            }

        }

        if ($null -ne $pushError) {

            throw $pushError

        }

        $commit = (Invoke-AvmGit @git -ArgumentList @('rev-parse', '--short', 'HEAD')).StdOut.Trim()

        return (& $result 'pass' $commit $preCommit @())

    }

    finally {

        Remove-Item -LiteralPath $staging -Recurse -Force -ProgressAction SilentlyContinue -ErrorAction SilentlyContinue

    }

}

# SIG # Begin signature block

# MIInUwYJKoZIhvcNAQcCoIInRDCCJ0ACAQExDzANBglghkgBZQMEAgEFADB5Bgor

# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG

# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCAzseRPttQAgAMD

# 2QR27G7lNuaR94723wfcIzk7axlu8aCCDMkwggYEMIID7KADAgECAhMzAAACHPrN

# 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

# CisGAQQBgjcCAQQwLwYJKoZIhvcNAQkEMSIEIPDsweQaWroDWo9o4mRMln4Yn95E

# ZDl25gpSlqq9sxXTMEIGCisGAQQBgjcCAQwxNDAyoBSAEgBNAGkAYwByAG8AcwBv

# AGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20wDQYJKoZIhvcNAQEBBQAE

# ggEAPVmWVLMjjIG6SmwplpBG6vwPddm8XBn1ZzSH1D+eYD9KrCtsntWooHZJefiW

# Xrbk/qu2P5gEQ2SvBomtseOFU+69uid2TXgRXb+wHtgD/dAU7ybUYxi2afS7UwUa

# Z7XIIJSumnEtMxAQ9sj7qyYMwevbqXaI38d2XPnNtY3+EcJGJjK8LItTUZcOxW0S

# bbwA++JqPUbkpjZ8uuq98xGrMuobleWaJFG2c5lsReciCT2Giqi/l/sKNUBEINeF

# 9qSFMMOGuNwOlvhZOmSm5tmjfmZZ5uhbatGg5MGBuGCh9CeP02oWfV6QLUbEv9o0

# 0iD8Onn5/2JYO/UtJ/oDzLmBpaGCF7AwghesBgorBgEEAYI3AwMBMYIXnDCCF5gG

# CSqGSIb3DQEHAqCCF4kwgheFAgEDMQ8wDQYJYIZIAWUDBAIBBQAwggFaBgsqhkiG

# 9w0BCRABBKCCAUkEggFFMIIBQQIBAQYKKwYBBAGEWQoDATAxMA0GCWCGSAFlAwQC

# AQUABCDlmTbXIcPYjfdHpdnxiWvbWSip7Ev0k8ZMWudCHK3maQIGaq9US6sYGBMy

# MDI2MTAwMTExMzk0OC41MzNaMASAAgH0oIHZpIHWMIHTMQswCQYDVQQGEwJVUzET

# MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV

# TWljcm9zb2Z0IENvcnBvcmF0aW9uMS0wKwYDVQQLEyRNaWNyb3NvZnQgSXJlbGFu

# ZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2

# NTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy

# dmljZaCCEf4wggcoMIIFEKADAgECAhMzAAACFRgD04EHJnxTAAEAAAIVMA0GCSqG

# SIb3DQEBCwUAMHwxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAw

# DgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24x

# JjAkBgNVBAMTHU1pY3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwMB4XDTI1MDgx

# NDE4NDgyMFoXDTI2MTExMzE4NDgyMFowgdMxCzAJBgNVBAYTAlVTMRMwEQYDVQQI

# EwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3Nv

# ZnQgQ29ycG9yYXRpb24xLTArBgNVBAsTJE1pY3Jvc29mdCBJcmVsYW5kIE9wZXJh

# dGlvbnMgTGltaXRlZDEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjY1MUEtMDVF

# MC1EOTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNlMIIC

# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAw3HV3hVxL0lEYPV03XeNKZ51

# 7VIbgexhlDPdpXwDS0BYtxPwi4XYpZR1ld0u6cr2Xjuugdg50DUx5WHL0QhY2d9v

# kJSk02rE/75hcKt91m2Ih287QRxRMmFu3BF6466k8qp5uXtfe6uciq49YaS8p+dz

# v3uTarD4hQ8UT7La95pOJiRqxxd0qOGLECvHLEXPXioNSx9pyhzhm6lt7ezLxJeF

# VYtxShkavPoZN0dOCiYeh4KgoKoyagzMuSiLCiMUW4Ue4Qsm658FJNGTNh7V5qXY

# VA6k5xjw5WeWdKOz0i9A5jBcbY9fVOo/cA8i1bytzcDTxb3nctcly8/OYeNstkab

# /Isq3Cxe1vq96fIHE1+ZGmJjka1sodwqPycVp/2tb+BjulPL5D6rgUXTPF84U82R

# LKHV57bB8fHRpgnjcWBQuXPgVeSXpERWimt0NF2lCOLzqgrvS/vYqde5Ln9YlKKh

# AZ/xDE0TLIIr6+I/2JTtXP34nfjTENVqMBISWcakIxAwGb3RB5yHCxynIFNVLcfK

# AsEdC5U2em0fAvmVv0sonqnv17cuaYi2eCLWhoK1Ic85Dw7s/lhcXrBpY4n/Rl5l

# 3wHzs4vOIhu87DIy5QUaEupEsyY0NWqgI4BWl6v1wgse+l8DWFeUXofhUuCgVTuT

# HN3K8idoMbn8Q3edUIECAwEAAaOCAUkwggFFMB0GA1UdDgQWBBSJIXfxcqAwFqGj

# 9jdwQtdSqadj1zAfBgNVHSMEGDAWgBSfpxVdAF5iXYP05dJlpxtTNRnpcjBfBgNV

# HR8EWDBWMFSgUqBQhk5odHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20vcGtpb3BzL2Ny

# bC9NaWNyb3NvZnQlMjBUaW1lLVN0YW1wJTIwUENBJTIwMjAxMCgxKS5jcmwwbAYI

# KwYBBQUHAQEEYDBeMFwGCCsGAQUFBzAChlBodHRwOi8vd3d3Lm1pY3Jvc29mdC5j

# b20vcGtpb3BzL2NlcnRzL01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAy

# MDEwKDEpLmNydDAMBgNVHRMBAf8EAjAAMBYGA1UdJQEB/wQMMAoGCCsGAQUFBwMI

# MA4GA1UdDwEB/wQEAwIHgDANBgkqhkiG9w0BAQsFAAOCAgEAd42HtV+kGbvxzLBT

# C5O7vkCIBPy/BwpjCzeL53hAiEOebp+VdNnwm9GVCfYq3KMfrj4UvKQTUAaS5Zkw

# e1gvZ3ljSSnCOyS5OwNu9dpg3ww+QW2eOcSLkyVAWFrLn6Iig3TC/zWMvVhqXtdF

# hG2KJ1lSbN222csY3E3/BrGluAlvET9gmxVyyxNy59/7JF5zIGcJibydxs94JL1B

# tPgXJOfZzQ+/3iTc6eDtmaWT6DKdnJocp8wkXKWPIsBEfkD6k1Qitwvt0mHrORah

# 75SjecOKt4oWayVLkPTho12e0ongEg1cje5fxSZGthrMrWKvI4R7HEC7k8maH9eP

# A3ViH0CVSSOefaPTGMzIhHCo5p3jG5SMcyO3eA9uEaYQJITJlLG3BwwGmypY7C/8

# /nj1SOhgx1HgJ0ywOJL9xfP4AOcWmCfbsqgGbCaC7WH5sINdzfMar8V7YNFqkbCG

# UKhc8GpIyE+MKnyVn33jsuaGAlNRg7dVRUSoYLJxvUsw9GOwyBpBwbE9sqOLm+Hs

# O00oF23PMio7WFXcFTZAjp3ujihBAfLrXICgGOHPdkZ042u1LZqOcnlr3XzvgMe+

# mPPyasW8f0rtzJj3V5E/EKiyQlPxj9Mfq2x9himnlXWGZCVPeEBROrNbDYBfazTy

# LNCOTsRtksOSV3FBtPnpQtLN754wggdxMIIFWaADAgECAhMzAAAAFcXna54Cm0mZ

# 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

# ZCBPcGVyYXRpb25zIExpbWl0ZWQxJzAlBgNVBAsTHm5TaGllbGQgVFNTIEVTTjo2

# NTFBLTA1RTAtRDk0NzElMCMGA1UEAxMcTWljcm9zb2Z0IFRpbWUtU3RhbXAgU2Vy

# dmljZaIjCgEBMAcGBSsOAwIaAxUAj6eTejbuYE1Ifjbfrt6tXevCUSCggYMwgYCk

# fjB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMH

# UmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSYwJAYDVQQD

# Ex1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDANBgkqhkiG9w0BAQsFAAIF

# AO5oUgUwIhgPMjAyNjEwMDEwMzI5MDlaGA8yMDI2MTAwMjAzMjkwOVowdzA9Bgor

# BgEEAYRZCgQBMS8wLTAKAgUA7mhSBQIBADAKAgEAAgIy4gIB/zAHAgEAAgISbzAK

# AgUA7mmjhQIBADA2BgorBgEEAYRZCgQCMSgwJjAMBgorBgEEAYRZCgMCoAowCAIB

# AAIDB6EgoQowCAIBAAIDAYagMA0GCSqGSIb3DQEBCwUAA4IBAQB7/6ZxHlHdUgVf

# gH+JjYux29a7+Z6A4eTeDFa0OcjYRLMrwhXri8hPvcKWtR2xQZ4PcQWhAsmbDNeQ

# 96tNX1OT5CjHUB6C60gKJWsxhvKZzAR1gTca9ZV6/MkZpUCuQ8F2BoK0H1ZSUg3i

# INanmW89nahJVZhPPe8GGvyjWct/4S4WPB/SPRY36U2ZDiHeBA/qwOu1v914I4aa

# IA9KW1IXFSE6El6TFu2o8/MAvXi+UPjQcTlIzTFA/UYy/FUJU+gGqAEdUl6c5VYZ

# jVb5KtxeIJtcYJOPPB9Euxx9/1bfLHpfRCGR5JBkvsFgJ4YHm+n751UWQ0+M+kKi

# 3GKDiSX9MYIEDTCCBAkCAQEwgZMwfDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldh

# c2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBD

# b3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIw

# MTACEzMAAAIVGAPTgQcmfFMAAQAAAhUwDQYJYIZIAWUDBAIBBQCgggFKMBoGCSqG

# SIb3DQEJAzENBgsqhkiG9w0BCRABBDAvBgkqhkiG9w0BCQQxIgQg40m5h9GNyaBJ

# s8ioS+PrPTO8+X0g6jmm8OUmjOiO8rgwgfoGCyqGSIb3DQEJEAIvMYHqMIHnMIHk

# MIG9BCBwEPR2PDrTFLcrtQsKrUi7oz5JNRCF/KRHMihSNe7sijCBmDCBgKR+MHwx

# CzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRt

# b25kMR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1p

# Y3Jvc29mdCBUaW1lLVN0YW1wIFBDQSAyMDEwAhMzAAACFRgD04EHJnxTAAEAAAIV

# MCIEIOz5X5wrmJ4cBgIiTiCAIaBKPE0RH6KuwEhWg/yXpTw6MA0GCSqGSIb3DQEB

# CwUABIICAH19l0IzBINiapyuqgWoc5joNK+M//OZ8jyqVo7Li7Mudy0OfFvwUhRk

# mjFf0aLVw8iJ8lfo4p9GkvYVGtFnvxad9DcuqZazGma0Y854l3fOvIdznYiAW/4Q

# VWN3Uy3LIMItOhGBdUXX7W2QmvzOJzAW8PPYvB9JL8oku6Sq3/Ed9FQQuuOpRfRH

# dn6wZTrcpCucz6oWcMeKo2lSIfEE9YBbWBtNq4sqyjT3vJjbP1yzcRmafvInlOJ+

# 9VYx0asGFVoj0wpFyEqpdsxwpnx7ID0clJGnsK0ozNxXKELIL/U1EwqHQoUpSpdr

# e0kBGDRHTkE7p+AKxT0YTeonwV4MVeLLEidHSLyEYGWxYaioYAiEIBTrwlPsD7eT

# wLUeeh9+wtdAkmDkDcPfHGWyr47Al4dtLqWHUZC2+ghl+T756pEbpTjdrYtIDqHw

# KI2Vyt2zDwDAFbEWyY/StE5BhA4a1aPT7lXS5VosvPKL5UH30JS/j1FKS8SIy0Fv

# 1SyTDqcTmB51R7wL6l6I5MBxwmMwpVGydT9F1nwNgiLADZkgZN217hqommSLo2Yx

# 0fnbuCfkSwJZbkGVmrWGhoKDjP6xg9zmaydqMXOOk1oDAWnP2OOrLJZwMTh/3DP7

# YBmvKHlLHnV3ggXrCu+jNwAxPuVtYBUlLCpYJW90eh1FzuI4Qpf9

# SIG # End signature block