Private/Reporting/ReportDispatch.ps1
|
# ----------------------------------------------------------------------------- # ReportDispatch.ps1 — side effects. # # All the impure stuff (file IO, clipboard, browser launch) lives here. # Renderers stay pure functions; this is the shell that turns their # output into real-world effects. # # Separating this from rendering means tests can exercise the full # renderer stack without touching the filesystem or user's clipboard. # ----------------------------------------------------------------------------- # ============================================================================ # ClipboardBridge: pure-C# helper for PS7 MTA clipboard access. # # On PS7 the default apartment is MTA, but [Windows.Forms.Clipboard] requires # STA. Running a PowerShell scriptblock on a bare STA thread fails because # the thread has no attached runspace. Solution: emit a C# class whose # ThreadStart is a pure CLR delegate — no PowerShell on the worker thread, # so no runspace required. Idempotent across re-imports. # # The bridge sets multi-format clipboard data (CF_HTML + CF_UNICODETEXT) via # DataObject so paste targets pick what they understand: rich-text editors # get CF_HTML and render it; plain-text editors fall back to UnicodeText. # ============================================================================ if (-not ('LISSTech.UserSessions.ClipboardBridge' -as [type]) -or -not ('LISSTech.UserSessions.ClipboardBridge' -as [type]).GetMethod('SetRich')) { try { Add-Type -ReferencedAssemblies System.Windows.Forms, System.Threading.Thread -TypeDefinition @' using System; using System.Threading; using System.Windows.Forms; namespace LISSTech.UserSessions { public static class ClipboardBridge { public static void SetRich(string cfHtml, string plainText) { Exception captured = null; Thread t = new Thread(delegate() { try { DataObject data = new DataObject(); if (cfHtml != null) data.SetData(DataFormats.Html, cfHtml); if (plainText != null) data.SetData(DataFormats.UnicodeText, plainText); Clipboard.SetDataObject(data, true); } catch (Exception ex) { captured = ex; } }); t.SetApartmentState(ApartmentState.STA); t.Start(); t.Join(); if (captured != null) throw captured; } } } '@ } catch { Write-Debug "ClipboardBridge Add-Type failed (type may already exist from a prior session — restart PowerShell to load updates): $($_.Exception.Message)" } } function ConvertTo-CfHtml { <# .SYNOPSIS Wraps an HTML document/fragment in the CF_HTML clipboard format with correct UTF-8 byte offsets in the header. CF_HTML requires: Version:0.9 StartHTML:NNNNNNNNNN EndHTML:NNNNNNNNNN StartFragment:NNNNNNNNNN EndFragment:NNNNNNNNNN [full HTML with <!--StartFragment--> ... <!--EndFragment--> markers placed INSIDE <body>] Critical detail: the fragment bounds the body CONTENT, not the <html> shell. Word / Outlook / Chrome / most rich-text paste targets refuse fragments that contain <!DOCTYPE>, <html>, or <head> tags and fall back to plain-text — which is why we have to split around <body> and insert the markers there. Fragments without <body> (a bare HTML snippet like "<p>hi</p>") get wrapped in minimal <html><body> scaffolding. #> [CmdletBinding()] param([Parameter(Mandatory)][string]$Html) $startMark = '<!--StartFragment-->' $endMark = '<!--EndFragment-->' # Split into pre-body / body-inner / post-body so we can place the # fragment markers inside <body>. $bodyOpen = [regex]::Match($Html, '<body\b[^>]*>', 'IgnoreCase') if ($bodyOpen.Success) { $bodyClose = [regex]::Match($Html, '</body\s*>', 'IgnoreCase') if ($bodyClose.Success -and $bodyClose.Index -gt ($bodyOpen.Index + $bodyOpen.Length)) { $preEnd = $bodyOpen.Index + $bodyOpen.Length $pre = $Html.Substring(0, $preEnd) $inner = $Html.Substring($preEnd, $bodyClose.Index - $preEnd) $post = $Html.Substring($bodyClose.Index) } else { # <body> without a matching </body> — treat whole input as inner # and add a minimal closing shell so the CF_HTML is well-formed. $pre = '<html><body>' $inner = $Html $post = '</body></html>' } } else { $pre = '<html><body>' $inner = $Html $post = '</body></html>' } # Pull any <style> blocks out of the pre-body region (typically <head>) # and prepend them inside the fragment. Paste targets only see what's # between <!--StartFragment--> and <!--EndFragment--> — anything in # <head> gets dropped — so a styled report whose CSS lives in <head> # would paste unstyled. Browsers do this same lift when you Ctrl+A # → copy out of a preview window. $styleMatches = [regex]::Matches($pre, '<style\b[^>]*>[\s\S]*?</style\s*>', 'IgnoreCase') if ($styleMatches.Count -gt 0) { $styles = ($styleMatches | ForEach-Object { $_.Value }) -join "`n" $inner = $styles + $inner } $utf8 = [System.Text.Encoding]::UTF8 $headerTemplate = "Version:0.9`r`nStartHTML:{0:D10}`r`nEndHTML:{1:D10}`r`nStartFragment:{2:D10}`r`nEndFragment:{3:D10}`r`n" $headerLen = $utf8.GetByteCount(($headerTemplate -f 0, 0, 0, 0)) # Byte offsets into the final payload: # [header][pre]<!--StartFragment-->[inner]<!--EndFragment-->[post] # StartFragment points at the first byte AFTER <!--StartFragment-->. # EndFragment points at the first byte OF <!--EndFragment-->. $startHtml = $headerLen $afterPre = $startHtml + $utf8.GetByteCount($pre) $startFragment = $afterPre + $utf8.GetByteCount($startMark) $endFragment = $startFragment + $utf8.GetByteCount($inner) $afterEndMark = $endFragment + $utf8.GetByteCount($endMark) $endHtml = $afterEndMark + $utf8.GetByteCount($post) ($headerTemplate -f $startHtml, $endHtml, $startFragment, $endFragment) + $pre + $startMark + $inner + $endMark + $post } function Set-ClipboardHtml { <# .SYNOPSIS Writes rich content to the Windows clipboard as CF_HTML (rendered paste into HaloPSA / Outlook / Word) plus an optional plain-text fallback (CF_UNICODETEXT) for editors that don't speak CF_HTML. Clipboard APIs require an STA thread. Windows PowerShell 5.1 is STA by default; PowerShell 7+ is MTA by default, so we detect and dispatch to a dedicated STA thread when needed. #> [CmdletBinding()] param( [Parameter(Mandatory)][string]$Html, [string]$PlainText ) Add-Type -AssemblyName System.Windows.Forms -ErrorAction Stop $cfHtml = ConvertTo-CfHtml -Html $Html $apartmentState = [System.Threading.Thread]::CurrentThread.ApartmentState if ($apartmentState -eq [System.Threading.ApartmentState]::STA) { $data = New-Object System.Windows.Forms.DataObject $data.SetData([System.Windows.Forms.DataFormats]::Html, $cfHtml) if ($PlainText) { $data.SetData([System.Windows.Forms.DataFormats]::UnicodeText, $PlainText) } [System.Windows.Forms.Clipboard]::SetDataObject($data, $true) return } $bridge = 'LISSTech.UserSessions.ClipboardBridge' -as [type] if (-not $bridge -or -not $bridge.GetMethod('SetRich')) { throw [System.PlatformNotSupportedException]::new( 'HTML clipboard unavailable: Windows Forms runtime (Microsoft.WindowsDesktop.App) not present in this PowerShell edition.') } [LISSTech.UserSessions.ClipboardBridge]::SetRich($cfHtml, $PlainText) } function Resolve-ReportClipboardDecision { <# .SYNOPSIS Pure function deciding whether to copy to clipboard. Extracted so the decision can be tested without touching the clipboard. Default behavior: clipboard ON unless -ReportPath was supplied (silent attachment mode). Explicit -Clipboard / -Clipboard:$false overrides the default in either direction. .OUTPUTS [bool] #> [CmdletBinding()] param( [bool]$ClipboardExplicit, [bool]$ClipboardOn, [bool]$HasReportPath ) if ($ClipboardExplicit) { return $ClipboardOn } -not $HasReportPath } function Resolve-ReportFilePath { <# .SYNOPSIS Pure function picking the effective file path. Returns the user- supplied path verbatim if given, otherwise a timestamped temp-dir path so the browser preview has something to open. #> [CmdletBinding()] param([string]$ReportPath) if ($ReportPath) { return $ReportPath } Join-Path $env:TEMP ("UserSession-Report-{0:yyyyMMdd-HHmmss}.html" -f (Get-Date)) } function Invoke-ReportDispatch { <# .SYNOPSIS Dispatches a rendered HTML report to file / clipboard / browser. Default: temp file + CF_HTML clipboard + browser preview. -ReportPath X: file only at X (silent attachment mode). -Clipboard:$false: suppresses the clipboard. #> [CmdletBinding()] param( [Parameter(Mandatory)] [string]$Content, [string]$ReportPath, [switch]$Clipboard ) $wroteFile = $false $copiedToClip = $false $browserOpened = $false $effectivePath = Resolve-ReportFilePath -ReportPath $ReportPath # ---- File write ---- if ($effectivePath) { try { $dir = Split-Path -Parent $effectivePath if ($dir -and -not (Test-Path $dir)) { New-Item -ItemType Directory -Path $dir -Force | Out-Null } [System.IO.File]::WriteAllText( $effectivePath, $Content, (New-Object System.Text.UTF8Encoding $true) ) $wroteFile = $true Write-Verbose "Report written to: $effectivePath" } catch { Write-Warning "Failed to write report to '$effectivePath': $($_.Exception.Message)" } } # ---- Clipboard ---- $clipboardExplicit = $PSBoundParameters.ContainsKey('Clipboard') $clipboardOn = [bool]$Clipboard $decisionArgs = @{ ClipboardExplicit = $clipboardExplicit ClipboardOn = $clipboardOn HasReportPath = [bool]$ReportPath } $shouldClipboard = Resolve-ReportClipboardDecision @decisionArgs Write-Debug "Invoke-ReportDispatch → ReportPath='$ReportPath' explicit=$clipboardExplicit on=$clipboardOn → $shouldClipboard" if ($shouldClipboard) { try { Set-ClipboardHtml -Html $Content -PlainText $Content $copiedToClip = $true } catch { Write-Warning "Failed to copy to clipboard: $($_.Exception.Message)" } } # ---- Browser preview (only when no explicit path) ---- if ($wroteFile -and -not $ReportPath) { try { Start-Process $effectivePath | Out-Null $browserOpened = $true } catch { Write-Warning "Failed to open browser: $($_.Exception.Message)" } } # ---- User-visible status ---- $bits = @() if ($copiedToClip) { $bits += 'copied to clipboard' } if ($wroteFile) { $bits += "saved to $effectivePath" } if ($browserOpened) { $bits += 'opened in browser' } if ($bits.Count -gt 0) { $p = $script:Palette Write-AnsiLine (' ' + $p.Success + '✓ Report: ' + $p.Reset + $p.TitleFg + ($bits -join ' · ') + $p.Reset) } # ---- Structured result for callers ---- [pscustomobject]@{ FilePath = if ($wroteFile) { $effectivePath } else { $null } Clipboard = $copiedToClip BrowserOpened = $browserOpened } } # SIG # Begin signature block # MIItnAYJKoZIhvcNAQcCoIItjTCCLYkCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCCAAEW+AHaN7MMl # Zw0ajDbQpwUJCwJgT2E5ryJInNEtcaCCJp8wggWNMIIEdaADAgECAhAOmxiO+dAt # 5+/bUOIIQBhaMA0GCSqGSIb3DQEBDAUAMGUxCzAJBgNVBAYTAlVTMRUwEwYDVQQK # EwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xJDAiBgNV # BAMTG0RpZ2lDZXJ0IEFzc3VyZWQgSUQgUm9vdCBDQTAeFw0yMjA4MDEwMDAwMDBa # Fw0zMTExMDkyMzU5NTlaMGIxCzAJBgNVBAYTAlVTMRUwEwYDVQQKEwxEaWdpQ2Vy # dCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5jb20xITAfBgNVBAMTGERpZ2lD # ZXJ0IFRydXN0ZWQgUm9vdCBHNDCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoC # ggIBAL/mkHNo3rvkXUo8MCIwaTPswqclLskhPfKK2FnC4SmnPVirdprNrnsbhA3E # MB/zG6Q4FutWxpdtHauyefLKEdLkX9YFPFIPUh/GnhWlfr6fqVcWWVVyr2iTcMKy # unWZanMylNEQRBAu34LzB4TmdDttceItDBvuINXJIB1jKS3O7F5OyJP4IWGbNOsF # xl7sWxq868nPzaw0QF+xembud8hIqGZXV59UWI4MK7dPpzDZVu7Ke13jrclPXuU1 # 5zHL2pNe3I6PgNq2kZhAkHnDeMe2scS1ahg4AxCN2NQ3pC4FfYj1gj4QkXCrVYJB # MtfbBHMqbpEBfCFM1LyuGwN1XXhm2ToxRJozQL8I11pJpMLmqaBn3aQnvKFPObUR # WBf3JFxGj2T3wWmIdph2PVldQnaHiZdpekjw4KISG2aadMreSx7nDmOu5tTvkpI6 # nj3cAORFJYm2mkQZK37AlLTSYW3rM9nF30sEAMx9HJXDj/chsrIRt7t/8tWMcCxB # YKqxYxhElRp2Yn72gLD76GSmM9GJB+G9t+ZDpBi4pncB4Q+UDCEdslQpJYls5Q5S # UUd0viastkF13nqsX40/ybzTQRESW+UQUOsxxcpyFiIJ33xMdT9j7CFfxCBRa2+x # q4aLT8LWRV+dIPyhHsXAj6KxfgommfXkaS+YHS312amyHeUbAgMBAAGjggE6MIIB # NjAPBgNVHRMBAf8EBTADAQH/MB0GA1UdDgQWBBTs1+OC0nFdZEzfLmc/57qYrhwP # TzAfBgNVHSMEGDAWgBRF66Kv9JLLgjEtUYunpyGd823IDzAOBgNVHQ8BAf8EBAMC # AYYweQYIKwYBBQUHAQEEbTBrMCQGCCsGAQUFBzABhhhodHRwOi8vb2NzcC5kaWdp # Y2VydC5jb20wQwYIKwYBBQUHMAKGN2h0dHA6Ly9jYWNlcnRzLmRpZ2ljZXJ0LmNv # bS9EaWdpQ2VydEFzc3VyZWRJRFJvb3RDQS5jcnQwRQYDVR0fBD4wPDA6oDigNoY0 # aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENB # LmNybDARBgNVHSAECjAIMAYGBFUdIAAwDQYJKoZIhvcNAQEMBQADggEBAHCgv0Nc # Vec4X6CjdBs9thbX979XB72arKGHLOyFXqkauyL4hxppVCLtpIh3bb0aFPQTSnov # Lbc47/T/gLn4offyct4kvFIDyE7QKt76LVbP+fT3rDB6mouyXtTP0UNEm0Mh65Zy # oUi0mcudT6cGAxN3J0TU53/oWajwvy8LpunyNDzs9wPHh6jSTEAZNUZqaVSwuKFW # juyk1T3osdz9HNj0d1pcVIxv76FQPfx2CWiEn2/K2yCNNWAcAgPLILCsWKAOQGPF # mCLBsln1VWvPJ6tsds5vIy30fnFqI2si/xK4VC0nftg62fC2h5b9W9FcrBjDTZ9z # twGpn1eqXijiuZQwggXfMIIEx6ADAgECAhBOQOQ3VO3mjAAAAABR05R/MA0GCSqG # SIb3DQEBCwUAMIG+MQswCQYDVQQGEwJVUzEWMBQGA1UEChMNRW50cnVzdCwgSW5j # LjEoMCYGA1UECxMfU2VlIHd3dy5lbnRydXN0Lm5ldC9sZWdhbC10ZXJtczE5MDcG # A1UECxMwKGMpIDIwMDkgRW50cnVzdCwgSW5jLiAtIGZvciBhdXRob3JpemVkIHVz # ZSBvbmx5MTIwMAYDVQQDEylFbnRydXN0IFJvb3QgQ2VydGlmaWNhdGlvbiBBdXRo # b3JpdHkgLSBHMjAeFw0yMTA1MDcxNTQzNDVaFw0zMDExMDcxNjEzNDVaMGkxCzAJ # BgNVBAYTAlVTMRYwFAYDVQQKDA1FbnRydXN0LCBJbmMuMUIwQAYDVQQDDDlFbnRy # dXN0IENvZGUgU2lnbmluZyBSb290IENlcnRpZmljYXRpb24gQXV0aG9yaXR5IC0g # Q1NCUjEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQCngY/3FEW2YkPy # 2K7TJV5IT1G/xX2fUBw10dZ+YSqUGW0nRqSmGl33VFFqgCLGqGZ1TVSDyV5oG6v2 # W2Swra0gvVTvRmttAudFrnX2joq5Mi6LuHccUk15iF+lOhjJUCyXJy2/2gB9Y3/v # MuxGh2Pbmp/DWiE2e/mb1cqgbnIs/OHxnnBNCFYVb5Cr+0i6udfBgniFZS5/tcnA # 4hS3NxFBBuKK4Kj25X62eAUBw2DtTwdBLgoTSeOQm3/dvfqsv2RR0VybtPVc51z/ # O5uloBrXfQmywrf/bhy8yH3m6Sv8crMU6UpVEoScRCV1HfYq8E+lID1oJethl3wP # 5bY9867DwRG8G47M4EcwXkIAhnHjWKwGymUfe5SmS1dnDH5erXhnW1XjXuvH2OxM # bobL89z4n4eqclgSD32m+PhCOTs8LOQyTUmM4OEAwjignPqEPkHcblauxhpb9Gdo # BQHNG7+uh7ydU/Yu6LZr5JnexU+HWKjSZR7IH9Vybu5ZHFc7CXKd18q3kMbNe0WS # kUIDTH0/yvKquMIOhvMQn0YupGaGaFpoGHApOBGAYGuKQ6NzbOOzazf/5p1nAZKG # 3y9I0ftQYNVc/iHTAUJj/u9wtBfAj6ju08FLXxLq/f0uDodEYOOp9MIYo+P9zgyE # Ig3zp3jak/PbOM+5LzPG/wc8Xr5F0wIDAQABo4IBKzCCAScwDgYDVR0PAQH/BAQD # AgGGMBIGA1UdEwEB/wQIMAYBAf8CAQEwHQYDVR0lBBYwFAYIKwYBBQUHAwMGCCsG # AQUFBwMIMDsGA1UdIAQ0MDIwMAYEVR0gADAoMCYGCCsGAQUFBwIBFhpodHRwOi8v # d3d3LmVudHJ1c3QubmV0L3JwYTAzBggrBgEFBQcBAQQnMCUwIwYIKwYBBQUHMAGG # F2h0dHA6Ly9vY3NwLmVudHJ1c3QubmV0MDAGA1UdHwQpMCcwJaAjoCGGH2h0dHA6 # Ly9jcmwuZW50cnVzdC5uZXQvZzJjYS5jcmwwHQYDVR0OBBYEFIK61j2Xzp/PceiS # N6/9s7VpNVfPMB8GA1UdIwQYMBaAFGpyJnrQHu995ztpUdRsjZ+QEmarMA0GCSqG # SIb3DQEBCwUAA4IBAQAfXkEEtoNwJFMsVXMdZTrA7LR7BJheWTgTCaRZlEJeUL9P # bG4lIJCTWEAN9Rm0Yu4kXsIBWBUCHRAJb6jU+5J+Nzg+LxR9jx1DNmSzZhNfFMyl # cfdbIUvGl77clfxwfREc0yHd0CQ5KcX+Chqlz3t57jpv3ty/6RHdFoMI0yyNf02o # FHkvBWFSOOtg8xRofcuyiq3AlFzkJg4sit1Gw87kVlHFVuOFuE2bRXKLB/GK+0m4 # X9HyloFdaVIk8Qgj0tYjD+uL136LwZNr+vFie1jpUJuXbheIDeHGQ5jXgWG2hZ1H # 7LGerj8gO0Od2KIc4NR8CMKvdgb4YmZ6tvf6yK81MIIGgzCCBGugAwIBAgIQNa+3 # e500H2r8j4RGqzE1KzANBgkqhkiG9w0BAQ0FADBpMQswCQYDVQQGEwJVUzEWMBQG # A1UECgwNRW50cnVzdCwgSW5jLjFCMEAGA1UEAww5RW50cnVzdCBDb2RlIFNpZ25p # bmcgUm9vdCBDZXJ0aWZpY2F0aW9uIEF1dGhvcml0eSAtIENTQlIxMB4XDTIxMDUw # NzE5MTk1MloXDTQwMTIyOTIzNTkwMFowYzELMAkGA1UEBhMCVVMxFjAUBgNVBAoT # DUVudHJ1c3QsIEluYy4xPDA6BgNVBAMTM0VudHJ1c3QgRXh0ZW5kZWQgVmFsaWRh # dGlvbiBDb2RlIFNpZ25pbmcgQ0EgLSBFVkNTMjCCAiIwDQYJKoZIhvcNAQEBBQAD # ggIPADCCAgoCggIBAL69pznJpX3sXWXx9Cuph9DnrRrFGjsYzuGhUY1y+s5YH1y4 # JEIPRtUxl9BKTeObMMm6l6ic/kU2zyeA53u4bsEkt9+ndNyF8qMkWEXMlJQ7AuvE # jXxG9VxmguOkwdMfrG4MUyMO1Dr62kLxg1RfNTJW8rV4m1cASB6pYWEnDnMDQ7bW # cJL71IWaMMaz5ppeS+8dKthmqxZG/wvYD6aJSgJRV0E8QThOl8dRMm1njmahXk2f # NSKv1Wq3f0BfaDXMafrxBfDqhabqMoXLwcHKg2lFSQbcCWy6SWUZjPm3NyeMZJ41 # 4+Xs5wegnahyvG+FOiymFk49nM8I5oL1RH0owL2JrWwv3C94eRHXHHBL3Z0ITF4u # +o29p91j9n/wUjGEbjrY2VyFRJ5jBmnQhlh4iZuHu1gcpChsxv5pCpwerBFgal7J # aWUu7UMtafF4tzstNfKqT+If4wFvkEaq1agNBFegtKzjbb2dGyiAJ0bH2qpnlfHR # h3vHyCXphAyPiTbSvjPhhcAz1aA8GYuvOPLlk4C/xsOre5PEPZ257kV2wNRobzBe # PLQ2+ddFQuASBoDbpSH85wV6KI20jmB798i1SkesFGaXoFppcjFXa1OEzWG6cwcV # cDt7AfynP4wtPYeM+wjX5S8Xg36Cq08J8inhflV3ZZQFHVnUCt2TfuMUXeK7AgMB # AAGjggErMIIBJzASBgNVHRMBAf8ECDAGAQH/AgEAMB0GA1UdDgQWBBTOiU+CUaoV # ooRiyjEjYdJh+/j+eDAfBgNVHSMEGDAWgBSCutY9l86fz3Hokjev/bO1aTVXzzAz # BggrBgEFBQcBAQQnMCUwIwYIKwYBBQUHMAGGF2h0dHA6Ly9vY3NwLmVudHJ1c3Qu # bmV0MDEGA1UdHwQqMCgwJqAkoCKGIGh0dHA6Ly9jcmwuZW50cnVzdC5uZXQvY3Ni # cjEuY3JsMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEFBQcDAzBEBgNV # HSAEPTA7MDAGBFUdIAAwKDAmBggrBgEFBQcCARYaaHR0cDovL3d3dy5lbnRydXN0 # Lm5ldC9ycGEwBwYFZ4EMAQMwDQYJKoZIhvcNAQENBQADggIBAD4AVLgq849mr2EW # xFiTZPRBi2RVjRs1M6GbkdirRsqrX7y+fnDk0tcHqJYH14bRVwoI0NB4Tfgq37IE # 85rh13zwwQB6wUCh34qMt8u0HQFh8piapt24gwXKqSwW3JwtDv6nl+RQqZeVwUsq # jFHjxALga3w1TVO8S5QTi1MYFl6mCqe4NMFssess5DF9DCzGfOGkVugtdtWyE3Xq # gwCuAHfGb6k97mMUgVAW/FtPEhkOWw+N6kvOBkyJS64gzI5HpnXWZe4vMOhdNI8f # gk1cQqbyFExQIJwJonQkXDnYiTKFPK+M5Wqe5gQ6pRP/qh3NR0suAgW0ao/rhU+B # 7wrbfZ8pj6XCP1I4UkGVO7w+W1QwQiMJY95QjYk1RfqruA+Poq17ehGT8Y8ohHto # eUdq6GQpTR/0HS9tHsiUhjzTWpl6a3yrNfcrOUtPuT8Wku8pjI2rrAEazHFEOctA # PiASzghw40f+3IDXCADRC2rqIbV5ZhfpaqpW3c0VeLEDwBStPkcYde0KU0syk83/ # gLGQ1hPl5EF4Iu1BguUO37DOlSFF5osB0xn39CtVrNlWc2MQ4LigbctUlpigmSFR # BqqmDDorY8t52kO50hLM3o9VeukJ8+Ka0yXBezaS2uDlUmfN4+ZUCqWd1HOj0y9d # BmSFA3d/YNjCvHTJlZFot7d+YRl1MIIGtDCCBJygAwIBAgIQDcesVwX/IZkuQEMi # DDpJhjANBgkqhkiG9w0BAQsFADBiMQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGln # aUNlcnQgSW5jMRkwFwYDVQQLExB3d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhE # aWdpQ2VydCBUcnVzdGVkIFJvb3QgRzQwHhcNMjUwNTA3MDAwMDAwWhcNMzgwMTE0 # MjM1OTU5WjBpMQswCQYDVQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4x # QTA/BgNVBAMTOERpZ2lDZXJ0IFRydXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQw # OTYgU0hBMjU2IDIwMjUgQ0ExMIICIjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKC # AgEAtHgx0wqYQXK+PEbAHKx126NGaHS0URedTa2NDZS1mZaDLFTtQ2oRjzUXMmxC # qvkbsDpz4aH+qbxeLho8I6jY3xL1IusLopuW2qftJYJaDNs1+JH7Z+QdSKWM06qc # hUP+AbdJgMQB3h2DZ0Mal5kYp77jYMVQXSZH++0trj6Ao+xh/AS7sQRuQL37QXbD # hAktVJMQbzIBHYJBYgzWIjk8eDrYhXDEpKk7RdoX0M980EpLtlrNyHw0Xm+nt5pn # YJU3Gmq6bNMI1I7Gb5IBZK4ivbVCiZv7PNBYqHEpNVWC2ZQ8BbfnFRQVESYOszFI # 2Wv82wnJRfN20VRS3hpLgIR4hjzL0hpoYGk81coWJ+KdPvMvaB0WkE/2qHxJ0ucS # 638ZxqU14lDnki7CcoKCz6eum5A19WZQHkqUJfdkDjHkccpL6uoG8pbF0LJAQQZx # st7VvwDDjAmSFTUms+wV/FbWBqi7fTJnjq3hj0XbQcd8hjj/q8d6ylgxCZSKi17y # Vp2NL+cnT6Toy+rN+nM8M7LnLqCrO2JP3oW//1sfuZDKiDEb1AQ8es9Xr/u6bDTn # YCTKIsDq1BtmXUqEG1NqzJKS4kOmxkYp2WyODi7vQTCBZtVFJfVZ3j7OgWmnhFr4 # yUozZtqgPrHRVHhGNKlYzyjlroPxul+bgIspzOwbtmsgY1MCAwEAAaOCAV0wggFZ # MBIGA1UdEwEB/wQIMAYBAf8CAQAwHQYDVR0OBBYEFO9vU0rp5AZ8esrikFb2L9RJ # 7MtOMB8GA1UdIwQYMBaAFOzX44LScV1kTN8uZz/nupiuHA9PMA4GA1UdDwEB/wQE # AwIBhjATBgNVHSUEDDAKBggrBgEFBQcDCDB3BggrBgEFBQcBAQRrMGkwJAYIKwYB # BQUHMAGGGGh0dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBBBggrBgEFBQcwAoY1aHR0 # cDovL2NhY2VydHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5j # cnQwQwYDVR0fBDwwOjA4oDagNIYyaHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0Rp # Z2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJ # YIZIAYb9bAcBMA0GCSqGSIb3DQEBCwUAA4ICAQAXzvsWgBz+Bz0RdnEwvb4LyLU0 # pn/N0IfFiBowf0/Dm1wGc/Do7oVMY2mhXZXjDNJQa8j00DNqhCT3t+s8G0iP5kvN # 2n7Jd2E4/iEIUBO41P5F448rSYJ59Ib61eoalhnd6ywFLerycvZTAz40y8S4F3/a # +Z1jEMK/DMm/axFSgoR8n6c3nuZB9BfBwAQYK9FHaoq2e26MHvVY9gCDA/JYsq7p # GdogP8HRtrYfctSLANEBfHU16r3J05qX3kId+ZOczgj5kjatVB+NdADVZKON/gnZ # ruMvNYY2o1f4MXRJDMdTSlOLh0HCn2cQLwQCqjFbqrXuvTPSegOOzr4EWj7PtspI # HBldNE2K9i697cvaiIo2p61Ed2p8xMJb82Yosn0z4y25xUbI7GIN/TpVfHIqQ6Ku # /qjTY6hc3hsXMrS+U0yy+GWqAXam4ToWd2UQ1KYT70kZjE4YtL8Pbzg0c1ugMZyZ # Zd/BdHLiRu7hAWE6bTEm4XYRkA6Tl4KSFLFk43esaUeqGkH/wyW4N7OigizwJWeu # kcyIPbAvjSabnf7+Pu0VrFgoiovRDiyx3zEdmcif/sYQsfch28bZeUz2rtY/9TCA # 6TD8dC3JE3rYkrhLULy7Dc90G6e8BlqmyIjlgp2+VqsS9/wQD7yFylIz0scmbKvF # oW2jNrbM1pD2T7m3XDCCBu0wggTVoAMCAQICEAqA7xhLjfEFgtHEdqeVdGgwDQYJ # KoZIhvcNAQELBQAwaTELMAkGA1UEBhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJ # bmMuMUEwPwYDVQQDEzhEaWdpQ2VydCBUcnVzdGVkIEc0IFRpbWVTdGFtcGluZyBS # U0E0MDk2IFNIQTI1NiAyMDI1IENBMTAeFw0yNTA2MDQwMDAwMDBaFw0zNjA5MDMy # MzU5NTlaMGMxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjE7 # MDkGA1UEAxMyRGlnaUNlcnQgU0hBMjU2IFJTQTQwOTYgVGltZXN0YW1wIFJlc3Bv # bmRlciAyMDI1IDEwggIiMA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQDQRqwt # Esae0OquYFazK1e6b1H/hnAKAd/KN8wZQjBjMqiZ3xTWcfsLwOvRxUwXcGx8AUjn # i6bz52fGTfr6PHRNv6T7zsf1Y/E3IU8kgNkeECqVQ+3bzWYesFtkepErvUSbf+EI # YLkrLKd6qJnuzK8Vcn0DvbDMemQFoxQ2Dsw4vEjoT1FpS54dNApZfKY61HAldytx # NM89PZXUP/5wWWURK+IfxiOg8W9lKMqzdIo7VA1R0V3Zp3DjjANwqAf4lEkTlCDQ # 0/fKJLKLkzGBTpx6EYevvOi7XOc4zyh1uSqgr6UnbksIcFJqLbkIXIPbcNmA98Os # kkkrvt6lPAw/p4oDSRZreiwB7x9ykrjS6GS3NR39iTTFS+ENTqW8m6THuOmHHjQN # C3zbJ6nJ6SXiLSvw4Smz8U07hqF+8CTXaETkVWz0dVVZw7knh1WZXOLHgDvundrA # tuvz0D3T+dYaNcwafsVCGZKUhQPL1naFKBy1p6llN3QgshRta6Eq4B40h5avMcpi # 54wm0i2ePZD5pPIssoszQyF4//3DoK2O65Uck5Wggn8O2klETsJ7u8xEehGifgJY # i+6I03UuT1j7FnrqVrOzaQoVJOeeStPeldYRNMmSF3voIgMFtNGh86w3ISHNm0Ia # adCKCkUe2LnwJKa8TIlwCUNVwppwn4D3/Pt5pwIDAQABo4IBlTCCAZEwDAYDVR0T # AQH/BAIwADAdBgNVHQ4EFgQU5Dv88jHt/f3X85FxYxlQQ89hjOgwHwYDVR0jBBgw # FoAU729TSunkBnx6yuKQVvYv1Ensy04wDgYDVR0PAQH/BAQDAgeAMBYGA1UdJQEB # /wQMMAoGCCsGAQUFBwMIMIGVBggrBgEFBQcBAQSBiDCBhTAkBggrBgEFBQcwAYYY # aHR0cDovL29jc3AuZGlnaWNlcnQuY29tMF0GCCsGAQUFBzAChlFodHRwOi8vY2Fj # ZXJ0cy5kaWdpY2VydC5jb20vRGlnaUNlcnRUcnVzdGVkRzRUaW1lU3RhbXBpbmdS # U0E0MDk2U0hBMjU2MjAyNUNBMS5jcnQwXwYDVR0fBFgwVjBUoFKgUIZOaHR0cDov # L2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZEc0VGltZVN0YW1waW5n # UlNBNDA5NlNIQTI1NjIwMjVDQTEuY3JsMCAGA1UdIAQZMBcwCAYGZ4EMAQQCMAsG # CWCGSAGG/WwHATANBgkqhkiG9w0BAQsFAAOCAgEAZSqt8RwnBLmuYEHs0QhEnmNA # ciH45PYiT9s1i6UKtW+FERp8FgXRGQ/YAavXzWjZhY+hIfP2JkQ38U+wtJPBVBaj # YfrbIYG+Dui4I4PCvHpQuPqFgqp1PzC/ZRX4pvP/ciZmUnthfAEP1HShTrY+2DE5 # qjzvZs7JIIgt0GCFD9ktx0LxxtRQ7vllKluHWiKk6FxRPyUPxAAYH2Vy1lNM4kze # kd8oEARzFAWgeW3az2xejEWLNN4eKGxDJ8WDl/FQUSntbjZ80FU3i54tpx5F/0Kr # 15zW/mJAxZMVBrTE2oi0fcI8VMbtoRAmaaslNXdCG1+lqvP4FbrQ6IwSBXkZagHL # hFU9HCrG/syTRLLhAezu/3Lr00GrJzPQFnCEH1Y58678IgmfORBPC1JKkYaEt2Od # Dh4GmO0/5cHelAK2/gTlQJINqDr6JfwyYHXSd+V08X1JUPvB4ILfJdmL+66Gp3CS # BXG6IwXMZUXBhtCyIaehr0XkBoDIGMUG1dUtwq1qmcwbdUfcSYCn+OwncVUXf53V # JUNOaMWMts0VlRYxe5nK+At+DI96HAlXHAL5SlfYxJ7La54i71McVWRP66bW+yER # NpbJCjyCYG2j+bdpxo/1Cy4uPcU3AWVPGrbn5PhDBf3Froguzzhk++ami+r3Qrx5 # bIbY3TVzgiFI7Gq3zWcwggb3MIIE36ADAgECAhBUqhzmzdht2UDqAdaKxc8tMA0G # CSqGSIb3DQEBCwUAMGMxCzAJBgNVBAYTAlVTMRYwFAYDVQQKEw1FbnRydXN0LCBJ # bmMuMTwwOgYDVQQDEzNFbnRydXN0IEV4dGVuZGVkIFZhbGlkYXRpb24gQ29kZSBT # aWduaW5nIENBIC0gRVZDUzIwHhcNMjMxMTExMDIzNDE2WhcNMjYxMTExMDIzNDE1 # WjCB0jELMAkGA1UEBhMCVVMxETAPBgNVBAgTCE5ldyBZb3JrMQ8wDQYDVQQHEwZS # b3NseW4xEzARBgsrBgEEAYI3PAIBAxMCVVMxGTAXBgsrBgEEAYI3PAIBAhMITmV3 # IFlvcmsxHjAcBgNVBAoTFUxJU1MgQ29uc3VsdGluZyBDb3JwLjEdMBsGA1UEDxMU # UHJpdmF0ZSBPcmdhbml6YXRpb24xEDAOBgNVBAUTBzEyMDM3MDQxHjAcBgNVBAMT # FUxJU1MgQ29uc3VsdGluZyBDb3JwLjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCC # AgoCggIBAKNsPm91CdVgVgztDDAOq1XypBtPfEFiuIjryZikaVh3+iPoixSaa4MA # MZe8gR//KdBwqwyfKHRLj79VfmtcRQJtcuuzfdRXlmnvZOcfwOuhnl7dp3ZyON2B # +m/wTxvRulpTfOf7Xa/XD+vseSMZk5Cr3VGs5c8CnfFPxboSGjxPI5iNfEe/hJvI # BS/aYVL/sZqNdCqarwUCC0YuaVCbOiOlpV1h3hfrVQq9eB5FVI8u7YRh0jetAt96 # LoiYwXxmLdxXtMHAZPhLCfJndTVwOgo6P08j+BFViHtHZGOLgH9gC32OPZvGAM69 # IoessdwAK31fBO/alVk2TBnjjaCMiLD7goDYIP9GzDE+o8rO8pcyse4a1s+uF4By # DiotV0/3L1XFneFA9llG1PgmpU0P7myHJGa2BTUuNcZ5NVNEdINGCg3rDEb2oRje # ukOn83iRtsTnV8kdd4BXuEFptjNqj9M6fvk+LJxsZZ7pKaNGlugPH/hb93+2WXd3 # ImzPCLBOQBs9Ms7rgjlGzfZP/cTJibogaYNYhb6mblEHpm5UhBNrJk9ONRNfDjDB # Lz7eeAWtZGHerL3vpaBHCC4QA1aIKMmolnXjBCAsEhqbJnKZEb/fVjfU7fX5/TQJ # lu+w6AZ6y4rBITex0QMGUlcYh1pnQf0tTikfyH250Gyr1pBaD1rvAgMBAAGjggE1 # MIIBMTAMBgNVHRMBAf8EAjAAMB0GA1UdDgQWBBS8w1GaCwrKaNGXgF9k+1HbSv8Y # uTAfBgNVHSMEGDAWgBTOiU+CUaoVooRiyjEjYdJh+/j+eDBnBggrBgEFBQcBAQRb # MFkwIwYIKwYBBQUHMAGGF2h0dHA6Ly9vY3NwLmVudHJ1c3QubmV0MDIGCCsGAQUF # BzAChiZodHRwOi8vYWlhLmVudHJ1c3QubmV0L2V2Y3MyLWNoYWluLnA3YzAxBgNV # HR8EKjAoMCagJKAihiBodHRwOi8vY3JsLmVudHJ1c3QubmV0L2V2Y3MyLmNybDAO # BgNVHQ8BAf8EBAMCB4AwEwYDVR0lBAwwCgYIKwYBBQUHAwMwIAYDVR0gBBkwFzAH # BgVngQwBAzAMBgpghkgBhvpsCgECMA0GCSqGSIb3DQEBCwUAA4ICAQBoCI/Q8Bgz # wIuP21o96o9uMEbhUfRQ6JBB2/1jfNHJewHbMk9D3ftAEYj7nJSWeLpk8TOSPeeg # tpsG8BEj3KZxDKg08jxWcDMCi0SBh31I3gMQowFh8fD3QjgMpb4gW5r9TZttLn2G # txzBuoamhesLb3Bfr492InciZbSXgipiaKUa5ocj1mOuo9Y8I/SlN8yhuREULW59 # JsvWwcNDInmTyxNuQ/4HoeBzXn7I3CY+rlm4aXOmnhE3Fbe3jINEFkCIROTOQ+Ps # gFlOFaz0gGuT8gfmSxiCrMzE90Nfucuay/RxCRsh9Xqu9uxyHCQCuJ4gvvGj431f # UpCOAzRM/ogk9Udna8Gs22tmCrfMQAT+KNtuewT0EYH4qqpkrAxm9RQwUk7cMG35 # ebua7D3pe4OwKe8TldRibPxKBMWueJll+Ku/jWRIL2urhwD1wqZtguYqoLqXHWQR # bd7nt60I+VxIusDiK80OyHXK7gAy1ibC7eAlpaOTOcJ92RAX6cIzKmutaxZLNZtl # u6n/aSBs7saPOb+848VgadEmBXQzOyRspay8JwQ+7C5Tuqa8/S7Qr6yKD7Sosm31 # ZOk8v59Oy+0Q4YiO0gkua/yZpnxGeutJVYteE8t7muhHk3zoGkMmG/K6CvxK3rxz # LuvDI0xr73Ai+rIuifNtzu4NvT8hBzGkwTGCBlMwggZPAgEBMHcwYzELMAkGA1UE # BhMCVVMxFjAUBgNVBAoTDUVudHJ1c3QsIEluYy4xPDA6BgNVBAMTM0VudHJ1c3Qg # RXh0ZW5kZWQgVmFsaWRhdGlvbiBDb2RlIFNpZ25pbmcgQ0EgLSBFVkNTMgIQVKoc # 5s3YbdlA6gHWisXPLTANBglghkgBZQMEAgEFAKCBhDAYBgorBgEEAYI3AgEMMQow # CKACgAChAoAAMBkGCSqGSIb3DQEJAzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcC # AQsxDjAMBgorBgEEAYI3AgEVMC8GCSqGSIb3DQEJBDEiBCDWPZhvyZzfFDlH8hlb # FXz0cGkRtCf0vO9qgs2XN1+tcDANBgkqhkiG9w0BAQEFAASCAgB3cA7y5D6aF90c # NwFP7bXLwsBseVREorJg58dKZ5EWbytAVJWCeL0soYNqTGpPeguArZfXzA6QNeNO # TAFNXChAPXhoI+/LycK/llP+45FnvS0Kh0WESs6y81jtuk5L1JMIxKhXgeND1AT6 # SqNLfZzMqCZV8xI89SqyINBtkXRiAAmSZdMNQLzCi74rxKUZjHez9IKFCAUu/mkL # cJ368j/4Qlwnu36JaD1jZtshFBGVN6/u8syjcKybQCAwPEp7unGwglV9cIkRXNU3 # DBHjOUxsmfqWqitCH1i0wcV213KX01212u5p/c9LdTB5jpSCI12FQLF6YD/EleNK # mbz/L9Mzy9Mjd73tj0QJ+677MYq2YfMJyS3F6o57pzqVt3kq+3AIWqg+TBl+5cPc # wZdIA7gPCQzGgnr71hoTRZlX0KwgEtiGjN5LDZzghj/ofOj7ddpGQ+0mJXcZzzN9 # KMNwZ1LlSB18RmRWF2zj8E7bH8yxzNlf4iLYi6HNdlgwTs8vmH+na3XC3thSe3XB # KDpnrcNN1NtUYiP+1B5q8B5f9BSfzglZhOrF+0RsCxNK8QV6R9Y6BU+Sm8CWvQEZ # EoFlnZIeMJpPCRN4VT7MqXQpnPOvaGoSL6ScW9UP7hXOp1ogZCYatoFGCQF3AHl6 # FVXMLLRR5YzeZs4NELlA8kE6d+FlgKGCAyYwggMiBgkqhkiG9w0BCQYxggMTMIID # DwIBATB9MGkxCzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFB # MD8GA1UEAxM4RGlnaUNlcnQgVHJ1c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5 # NiBTSEEyNTYgMjAyNSBDQTECEAqA7xhLjfEFgtHEdqeVdGgwDQYJYIZIAWUDBAIB # BQCgaTAYBgkqhkiG9w0BCQMxCwYJKoZIhvcNAQcBMBwGCSqGSIb3DQEJBTEPFw0y # NjA0MjQyMzEzNDVaMC8GCSqGSIb3DQEJBDEiBCAcGqQh/sXe+87zvzGEcSnzBj5l # 2txEF0meqEis31stljANBgkqhkiG9w0BAQEFAASCAgC/VspC49fX9K9pNJeyRNFz # Tm46ZDxNWUM+/GyugBjUj5xxWyBhyrep0d41ffQOpS2uLCgOQ0buyUAhVSR/x35c # H9XG9gT8jv1ayn1Gtym5HxjKVuPfFaDVBMKuE3X/snWj2Eyq0htYajwKZstYDIlP # C3niC6vvrQlEyAO0zapQ/N7HxRiDgqwzWoQCrCouvi+4knZLO5Vptaz8FIBxO/wu # Dj57KfKvpkDGwwkLxNJQ7/fCdBAOlHuJwJF8Bz9WgsRtzAsSB6v1AlJaPhOPgWsV # GIkjL8OEsv2tmBH39UDmPe0ij1m96U8G51Woxrsd/zg2dclXCO15YgYGhqmazGrq # EX/116GfSEWujYBtmAPP5k0H30YwwiCZ4V6kB31raJrrKZFsDWhtt+iPnnE76BYD # YPHfKng4Np7C2/X3/bLsWnPQrkI1ZnRFSmE2ccf8D/PVKy5T+QbyxCqVmAjKxU6N # GQFB6BDd3rbyuyU7GBClGcvXFWivJlSB/RmxYjU2FXPCSuGBR3hqBZp4ZKNzSrOp # Fb8QxSEiLTUO2CaP9rvQ+crsvmhnkBHO+s4HxunsNd6gvIvD0PTckpWXq40LxAvY # Sa5K1Xhp421hYIRj+1ET95TVyzIDk+fcaKdC9cOMlXj3F1xUnaQEDrxsy9oofjJc # P8M0S9QfHCquTGECGtuz7A== # SIG # End signature block |