Microsoft.AVS.CDR.psm1
|
$ErrorActionPreference = 'Stop' Set-StrictMode -Version Latest class DependencyGraphNode { [string]$Name [string]$Version [System.Collections.ArrayList]$Dependencies [bool]$NotFound [string]$Repository [string]$InstalledLocation DependencyGraphNode( [string]$Name, [string]$Version, [System.Collections.IList]$Dependencies, [bool]$NotFound, [string]$Repository, [string]$InstalledLocation ) { $this.Name = $Name $this.Version = $Version $this.Dependencies = [System.Collections.ArrayList]::new($Dependencies) $this.NotFound = $NotFound $this.Repository = $Repository $this.InstalledLocation = $InstalledLocation } } $script:defaultRedirectMap = @{ } $script:moduleMapCache = @{ } <# .SYNOPSIS Finds and validates a redirect for a dependency version. .PARAMETER RedirectMap Map entries: "Name@Version" -> "NewVersion", "Name" -> "Version", "Name@Version" -> "*" or "Name" -> "*" (retain version, normalize casing). .OUTPUTS Hashtable with ResolvedVersion, ResolvedName, and IsRedirected. #> function Find-DependencyRedirect { param( [Parameter(Mandatory = $true)] [string]$DependencyName, [Parameter(Mandatory = $false)] [AllowEmptyString()] [string]$DependencyVersion, [Parameter(Mandatory = $true)] [hashtable]$RedirectMap, [Parameter(Mandatory = $false)] [string]$Indent = "" ) if ([string]::IsNullOrWhiteSpace($DependencyVersion)) { if ($RedirectMap.ContainsKey($DependencyName)) { $depVersion = $RedirectMap[$DependencyName] Write-Verbose "${Indent}Resolved unversioned dependency: $DependencyName -> $depVersion (from redirect map)" $resolvedName = $DependencyName foreach ($entry in $RedirectMap.GetEnumerator()) { if ($entry.Key -eq $DependencyName) { $resolvedName = $entry.Key break } } return @{ ResolvedVersion = $depVersion ResolvedName = $resolvedName IsRedirected = $true } } else { throw "${Indent}Cannot conservatively resolve version for dependency '$DependencyName'. Please add a redirect mapping for this module." } } $isExactVersion = $true $normalizedDepVersion = $DependencyVersion # Version range like "[1.0, 1.0]", "[1.0, )", "(, 2.0]" if ($DependencyVersion -match '^(\[|\()([^,]*),\s*([^\]\)]*)(\]|\))$') { $openBracket = $matches[1] $minVer = $matches[2] $maxVer = $matches[3] $closeBracket = $matches[4] if ($minVer -and $maxVer -and ($minVer -eq $maxVer) -and ($openBracket -eq '[') -and ($closeBracket -eq ']')) { $normalizedDepVersion = $minVer # exact: [1.0, 1.0] } elseif ($maxVer -and (-not $minVer)) { $isExactVersion = $false $normalizedDepVersion = $maxVer # open-ended: (, 2.0] } elseif ($minVer -and (-not $maxVer)) { $isExactVersion = $false $normalizedDepVersion = $minVer # open-ended: [1.0, ) } else { $isExactVersion = $false $normalizedDepVersion = $minVer } } # Check name@version first, then name-only fallback $depKeyPattern = "${DependencyName}@${normalizedDepVersion}" $versionSpecificEntry = $null $nameOnlyEntry = $null foreach ($entry in $RedirectMap.GetEnumerator()) { if ($entry.Key -eq $depKeyPattern) { $versionSpecificEntry = $entry break } elseif ($null -eq $nameOnlyEntry -and $entry.Key -eq $DependencyName) { $nameOnlyEntry = $entry } } $matchedEntry = if ($versionSpecificEntry) { $versionSpecificEntry } else { $nameOnlyEntry } $isNameOnlyMatch = $null -eq $versionSpecificEntry -and $null -ne $nameOnlyEntry if ($matchedEntry) { $resolvedVersion = $matchedEntry.Value # "*" retains version but normalizes dependency name casing if ($resolvedVersion -eq "*") { $resolvedVersion = $normalizedDepVersion if ($isNameOnlyMatch) { $resolvedName = $matchedEntry.Key } else { $resolvedName = $matchedEntry.Key -replace '@.*$', '' } Write-Verbose "${Indent}Normalizing dependency name: $DependencyName -> $resolvedName (version $normalizedDepVersion retained)" return @{ ResolvedVersion = $resolvedVersion ResolvedName = $resolvedName IsRedirected = $true } } if ($isExactVersion -and $resolvedVersion -ne $normalizedDepVersion) { throw "${Indent}Cannot redirect exact version dependency '$DependencyName' from version $normalizedDepVersion to $resolvedVersion. Exact version specifications must redirect to the same version or have no redirect." } if ($isNameOnlyMatch) { $resolvedName = $matchedEntry.Key Write-Verbose "${Indent}Redirecting dependency: $DependencyName $DependencyVersion -> $resolvedVersion (from name-only redirect)" } else { $resolvedName = $matchedEntry.Key -replace '@.*$', '' Write-Verbose "${Indent}Redirecting dependency: $DependencyName $DependencyVersion -> $resolvedVersion (from redirect map)" } return @{ ResolvedVersion = $resolvedVersion ResolvedName = $resolvedName IsRedirected = $true } } else { return @{ ResolvedVersion = $normalizedDepVersion ResolvedName = $DependencyName IsRedirected = $false } } } <# .SYNOPSIS Merges redirect maps — OuterMap takes precedence. Loads module-specific map files from maps/ dir. #> function Get-MergedRedirectMap { param( [Parameter(Mandatory = $true)] [hashtable]$OuterMap, [Parameter(Mandatory = $true)] [string]$Name, [Parameter(Mandatory = $true)] [string]$Version ) $redirectMap = $OuterMap if ([string]::IsNullOrWhiteSpace($Version)) { $versionPatterns = @() } else { $baseVersion = $Version if ($Version -match '[\[\(]([0-9][0-9a-zA-Z.\-]*)') { $baseVersion = $matches[1] } $versionParts = $baseVersion -split '[.\-]' $major = $versionParts[0] $minor = if ($versionParts.Count -gt 1) { $versionParts[1] } else { "0" } $versionPatterns = @( $baseVersion, # Full version (e.g., 1.4.0.15939652 or 1.0.0-preview) "$major.$minor", # Major.Minor (e.g., 1.4) "$major" # Major only (e.g., 1) ) } $moduleMap = $null foreach ($versionPattern in $versionPatterns) { $cacheKey = "$Name@$versionPattern" if ($script:moduleMapCache.ContainsKey($cacheKey)) { Write-Verbose "Using cached redirect map for: $cacheKey" $moduleMap = $script:moduleMapCache[$cacheKey] break } $testPath = Join-Path $PSScriptRoot "maps" "$Name@$versionPattern.json" if (Test-Path $testPath) { Write-Verbose "Loading module-specific redirect map from: $testPath" $moduleMap = Get-Content $testPath -Raw | ConvertFrom-Json -AsHashtable $script:moduleMapCache[$cacheKey] = $moduleMap break } } if ($moduleMap) { $mergedMap = @{} foreach ($key in $moduleMap.Keys) { $mergedMap[$key] = $moduleMap[$key] } foreach ($key in $redirectMap.Keys) { $mergedMap[$key] = $redirectMap[$key] # Outer map wins } $redirectMap = $mergedMap } return $redirectMap } <# .SYNOPSIS Builds a dependency graph by recursively querying a remote repository via Find-PSResource. #> function Build-RemoteDependencyGraph { param( [Parameter(Mandatory = $true)] [string]$ModuleName, [Parameter(Mandatory = $true)] [string]$ModuleVersion, [Parameter(Mandatory = $true)] [hashtable]$Graph, [Parameter(Mandatory = $true)] [hashtable]$RedirectMap, [Parameter(Mandatory = $false)] [string]$Repository, [Parameter(Mandatory = $false)] [PSCredential]$Credential, [Parameter(Mandatory = $false)] [switch]$Prerelease, [Parameter(Mandatory = $false)] [int]$Depth = 0 ) $indent = " " * $Depth $moduleKey = "${ModuleName}@${ModuleVersion}" # Skip if already processed if ($Graph.ContainsKey($moduleKey)) { Write-Verbose "${indent}Already in graph: $moduleKey" return } $findParams = @{ Name = $ModuleName Version = $ModuleVersion } if ($Repository) { $findParams['Repository'] = $Repository } if ($Credential) { $findParams['Credential'] = $Credential } if ($Prerelease) { $findParams['Prerelease'] = $Prerelease } Write-Verbose "Looking for dependencies: $ModuleName version $ModuleVersion" $moduleInfo = Find-PSResource @findParams -ErrorAction SilentlyContinue | Select-Object -First 1 $notFound = $false if (-not $moduleInfo) { Write-Verbose "${indent}Module not found in repository: $ModuleName version $ModuleVersion (will validate after resolution)" $notFound = $true } Write-Verbose "${indent}Building graph for: $ModuleName version $ModuleVersion" $graphNode = [DependencyGraphNode]::new( $ModuleName, $ModuleVersion, [System.Collections.ArrayList]@(), $notFound, $(if ($moduleInfo) { $moduleInfo.Repository } else { $null }), $null ) $Graph[$moduleKey] = $graphNode if ($notFound) { return } $deps = $moduleInfo.Dependencies if (-not $deps -or $deps.Count -eq 0) { Write-Verbose "${indent}No dependencies for $ModuleName" return } Write-Verbose "${indent}Found $($deps.Count) dependency(ies)" foreach ($dep in $deps) { $depName = $dep.Name $depVersion = $dep.VersionRange $redirectResult = Find-DependencyRedirect -DependencyName $depName -DependencyVersion $depVersion ` -RedirectMap $RedirectMap -Indent $indent $resolvedDepVersion = $redirectResult.ResolvedVersion $resolvedDepName = $redirectResult.ResolvedName $depKey = "${resolvedDepName}@${resolvedDepVersion}" Write-Verbose "${indent} Dependency: $depKey" [void]$graphNode.Dependencies.Add($depKey) $depRedirectMap = Get-MergedRedirectMap -OuterMap $RedirectMap -Name $resolvedDepName -Version $resolvedDepVersion Build-RemoteDependencyGraph -ModuleName $resolvedDepName -ModuleVersion $resolvedDepVersion ` -Graph $Graph -RedirectMap $depRedirectMap -Repository $Repository -Credential $Credential -Prerelease:$Prerelease -Depth ($Depth + 1) } } <# .SYNOPSIS Compares two semver strings including prerelease labels. Returns -1, 0, or 1. Prerelease < release (1.0.0-alpha < 1.0.0). #> function Compare-SemVer { param( [Parameter(Mandatory = $true)] [string]$Version1, [Parameter(Mandatory = $true)] [string]$Version2 ) $v1Parts = $Version1 -split '-', 2 $v2Parts = $Version2 -split '-', 2 $v1Base = $v1Parts[0] $v2Base = $v2Parts[0] $v1Prerelease = if ($v1Parts.Count -gt 1) { $v1Parts[1] } else { $null } $v2Prerelease = if ($v2Parts.Count -gt 1) { $v2Parts[1] } else { $null } try { $v1Ver = [System.Version]$v1Base $v2Ver = [System.Version]$v2Base $baseCompare = $v1Ver.CompareTo($v2Ver) } catch { $baseCompare = [string]::Compare($v1Base, $v2Base, [StringComparison]::OrdinalIgnoreCase) } if ($baseCompare -ne 0) { return $baseCompare } # No prerelease > any prerelease (1.0.0 > 1.0.0-alpha) if ($null -eq $v1Prerelease -and $null -eq $v2Prerelease) { return 0 } if ($null -eq $v1Prerelease) { return 1 # v1 is release, v2 is prerelease } if ($null -eq $v2Prerelease) { return -1 # v1 is prerelease, v2 is release } # Both have prerelease — lexicographic: alpha < beta < dev < rc return [string]::Compare($v1Prerelease, $v2Prerelease, [StringComparison]::OrdinalIgnoreCase) } <# .SYNOPSIS Resolves diamond dependencies — selects the highest found version and updates all graph references. #> function Resolve-DiamondDependencies { param( [Parameter(Mandatory = $true)] [hashtable]$Graph ) # Group nodes by module name $moduleVersions = @{} foreach ($nodeKey in $Graph.Keys) { $node = $Graph[$nodeKey] $moduleName = $node.Name if (-not $moduleVersions.ContainsKey($moduleName)) { $moduleVersions[$moduleName] = @() } $moduleVersions[$moduleName] += @{ Key = $nodeKey VersionString = $node.Version Node = $node NotFound = $node.NotFound } } # Resolve conflicts — prefer found versions, then highest semver foreach ($moduleName in $moduleVersions.Keys) { $versions = $moduleVersions[$moduleName] if ($versions.Count -gt 1) { $sorted = $versions | Sort-Object -Property @{ Expression = { if ($_.NotFound) { "1" } else { "0" } } }, @{ Expression = { $ver = $_.VersionString $parts = $ver -split '-', 2 $base = $parts[0] $prerelease = if ($parts.Count -gt 1) { $parts[1] } else { $null } $verParts = $base -split '\.' $paddedBase = ($verParts | ForEach-Object { $_.PadLeft(10, '0') }) -join '.' # Release versions sort after prereleases $prereleaseKey = if ($null -eq $prerelease) { 'zzzzzzzzzz' } else { $prerelease } "$paddedBase|$prereleaseKey" } Descending = $true } $highest = $sorted[0] $conflicts = $sorted | Select-Object -Skip 1 $discardedNotFound = $conflicts | Where-Object { $_.NotFound } if ($discardedNotFound) { Write-Verbose " Discarding unavailable version(s): $($discardedNotFound.VersionString -join ', ') (higher version available)" } Write-Warning "Diamond dependency detected for '$moduleName': versions $($versions.VersionString -join ', '). Using highest available: $($highest.VersionString)" foreach ($conflict in $conflicts) { $oldKey = $conflict.Key $newKey = $highest.Key Write-Verbose " Redirecting $oldKey -> $newKey" # Update all references from old version to new foreach ($nodeKey in $Graph.Keys) { $node = $Graph[$nodeKey] for ($i = 0; $i -lt $node.Dependencies.Count; $i++) { if ($node.Dependencies[$i] -eq $oldKey) { $node.Dependencies[$i] = $newKey } } } $Graph.Remove($oldKey) } } } # Validate all remaining nodes were found foreach ($nodeKey in $Graph.Keys) { $node = $Graph[$nodeKey] if ($node.NotFound) { throw "Module not found: $($node.Name) version $($node.Version). No alternative version available to satisfy the dependency." } } } <# .SYNOPSIS Returns module keys in topological order (dependencies first). Warns on cycles. #> function Get-TopologicalOrder { param( [Parameter(Mandatory = $true)] [hashtable]$Graph ) $visited = @{} $visiting = @{} # For cycle detection $order = [System.Collections.ArrayList]@() function Visit { param([string]$NodeKey) if ($visited.ContainsKey($NodeKey)) { return } if ($visiting.ContainsKey($NodeKey)) { Write-Warning "Circular dependency detected involving: $NodeKey" return } $visiting[$NodeKey] = $true if ($Graph.ContainsKey($NodeKey)) { $node = $Graph[$NodeKey] foreach ($depKey in $node.Dependencies) { Visit -NodeKey $depKey } } $visiting.Remove($NodeKey) $visited[$NodeKey] = $true [void]$order.Add($NodeKey) } # Visit all nodes foreach ($nodeKey in $Graph.Keys) { Visit -NodeKey $nodeKey } return $order.ToArray() } <# .SYNOPSIS Builds a dependency graph for installed modules via Get-PSResource. #> function Build-InstalledDependencyGraph { param( [Parameter(Mandatory = $true)] [string]$ModuleName, [Parameter(Mandatory = $true)] [string]$ModuleVersion, [Parameter(Mandatory = $true)] [hashtable]$Graph, [Parameter(Mandatory = $true)] [hashtable]$RedirectMap, [Parameter(Mandatory = $false)] [int]$Depth = 0 ) $indent = " " * $Depth $moduleKey = "${ModuleName}@${ModuleVersion}" # Skip if already processed if ($Graph.ContainsKey($moduleKey)) { Write-Verbose "${indent}Already in graph: $moduleKey" return } # Find the installed module $installedModule = Get-PSResource -Name $ModuleName -Version $ModuleVersion -ErrorAction SilentlyContinue | Select-Object -First 1 $notFound = $false if (-not $installedModule) { Write-Verbose "${indent}Module not installed: $ModuleName version $ModuleVersion (will validate after resolution)" $notFound = $true } $actualVersion = if ($installedModule) { $installedModule.Version.ToString() } else { $ModuleVersion } Write-Verbose "${indent}Building graph for: $ModuleName version $actualVersion" # InstalledLocation is the base modules folder; append ModuleName/Version $moduleVersionPath = if ($installedModule) { Join-Path $installedModule.InstalledLocation $ModuleName $actualVersion } else { $null } $graphNode = [DependencyGraphNode]::new( $ModuleName, $actualVersion, [System.Collections.ArrayList]@(), $notFound, $null, $moduleVersionPath ) $Graph[$moduleKey] = $graphNode if ($notFound) { return } $deps = $installedModule.Dependencies if (-not $deps -or $deps.Count -eq 0) { Write-Verbose "${indent}No dependencies for $ModuleName" return } Write-Verbose "${indent}Found $($deps.Count) dependency(ies)" foreach ($dep in $deps) { $depName = $dep.Name $depVersion = $dep.VersionRange $redirectResult = Find-DependencyRedirect -DependencyName $depName -DependencyVersion $depVersion ` -RedirectMap $RedirectMap -Indent $indent $resolvedDepVersion = $redirectResult.ResolvedVersion $resolvedDepName = $redirectResult.ResolvedName $depKey = "${resolvedDepName}@${resolvedDepVersion}" Write-Verbose "${indent} Dependency: $depKey" [void]$graphNode.Dependencies.Add($depKey) $depRedirectMap = Get-MergedRedirectMap -OuterMap $RedirectMap -Name $resolvedDepName -Version $resolvedDepVersion Build-InstalledDependencyGraph -ModuleName $resolvedDepName -ModuleVersion $resolvedDepVersion ` -Graph $Graph -RedirectMap $depRedirectMap -Depth ($Depth + 1) } } function Install-PSResourcePinned { <# .SYNOPSIS Installs a module with pinned dependency versions. Works around PowerCLI not following semver (13.4 breaks backward-compat). .EXAMPLE Install-PSResourcePinned -Name "VMware.PowerCLI" -RequiredVersion "13.3.0" #> [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$Name, [Parameter(Mandatory = $true)] [string]$RequiredVersion, [Parameter(Mandatory = $false)] [string]$RedirectMapPath, [Parameter(Mandatory = $false)] [ValidateSet('CurrentUser', 'AllUsers')] [string]$Scope = 'CurrentUser', [Parameter(Mandatory = $false)] [string]$Repository, [Parameter(Mandatory = $false)] [PSCredential]$Credential, [Parameter(Mandatory = $false)] [switch]$Prerelease, [Parameter(Mandatory = $false)] [switch]$Force ) # Load redirect map if ($RedirectMapPath) { if (-not (Test-Path $RedirectMapPath)) { throw "Redirect map file not found: $RedirectMapPath" } Write-Verbose "Loading redirect map from: $RedirectMapPath" $redirectMap = Get-Content $RedirectMapPath -Raw | ConvertFrom-Json -AsHashtable } else { Write-Verbose "Using default redirect map" $redirectMap = $script:defaultRedirectMap } $redirectMap = Get-MergedRedirectMap -OuterMap $redirectMap -Name $Name -Version $RequiredVersion Write-Verbose "Building dependency graph for $Name version $RequiredVersion" $dependencyGraph = @{} Build-RemoteDependencyGraph -ModuleName $Name -ModuleVersion $RequiredVersion ` -Graph $dependencyGraph -RedirectMap $redirectMap -Repository $Repository -Credential $Credential -Prerelease:$Prerelease Resolve-DiamondDependencies -Graph $dependencyGraph Write-Verbose "Computing topological order" $topologicalOrder = @(Get-TopologicalOrder -Graph $dependencyGraph) Write-Verbose "Install order ($($topologicalOrder.Count) modules):" for ($i = 0; $i -lt $topologicalOrder.Count; $i++) { Write-Verbose " $($i + 1). $($topologicalOrder[$i])" } # Install modules in topological order foreach ($moduleKey in $topologicalOrder) { $node = $dependencyGraph[$moduleKey] $modName = $node.Name $modVersion = $node.Version $installed = $null if (-not $Force) { $installed = Get-PSResource -Name $modName -ErrorAction SilentlyContinue | Where-Object { if (-not $_) { return $false } $installedVersion = $_.Version.ToString() if ($_.Prerelease) { $installedVersion = "$installedVersion-$($_.Prerelease)" } $installedVersion -eq $modVersion } } if (-not $installed) { Write-Verbose "Installing: $modName version $modVersion" $installParams = @{ Name = $modName Version = $modVersion Scope = $Scope Prerelease = $Prerelease TrustRepository = $true SkipDependencyCheck = $true } if ($Repository) { $installParams['Repository'] = $Repository } if ($Credential) { $installParams['Credential'] = $Credential } if ($Force) { $installParams['Reinstall'] = $true } Install-PSResource @installParams } else { Write-Verbose "Already installed: $modName version $modVersion" } } $mainModuleKey = "${Name}@${RequiredVersion}" $mainNode = $dependencyGraph[$mainModuleKey] Write-Host "Successfully installed $Name version $($mainNode.Version)" } function Save-PSResourcePinned { <# .SYNOPSIS Downloads a module and its dependencies with pinned versions. Saves as expanded module folders by default; pass -AsNupkg to save as NuGet packages. .EXAMPLE Save-PSResourcePinned -Name "VMware.PowerCLI" -RequiredVersion "13.3.0" -Path "./packages" .EXAMPLE Save-PSResourcePinned -Name "VMware.PowerCLI" -RequiredVersion "13.3.0" -Path "./packages" -AsNupkg #> [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$Name, [Parameter(Mandatory = $true)] [string]$RequiredVersion, [Parameter(Mandatory = $true)] [string]$Path, [Parameter(Mandatory = $false)] [string]$RedirectMapPath, [Parameter(Mandatory = $false)] [string]$Repository, [Parameter(Mandatory = $false)] [PSCredential]$Credential, [Parameter(Mandatory = $false)] [switch]$AsNupkg, [Parameter(Mandatory = $false)] [switch]$Prerelease ) # Validate and create destination path if (-not (Test-Path $Path)) { Write-Verbose "Creating destination directory: $Path" New-Item -ItemType Directory -Path $Path -Force | Out-Null } $resolvedPath = Resolve-Path $Path Write-Verbose "Saving packages to: $resolvedPath" # Load redirect map if ($RedirectMapPath) { if (-not (Test-Path $RedirectMapPath)) { throw "Redirect map file not found: $RedirectMapPath" } Write-Verbose "Loading redirect map from: $RedirectMapPath" $redirectMap = Get-Content $RedirectMapPath -Raw | ConvertFrom-Json -AsHashtable } else { Write-Verbose "Using default redirect map" $redirectMap = $script:defaultRedirectMap } $redirectMap = Get-MergedRedirectMap -OuterMap $redirectMap -Name $Name -Version $RequiredVersion Write-Verbose "Building dependency graph for $Name version $RequiredVersion" $dependencyGraph = @{} Build-RemoteDependencyGraph -ModuleName $Name -ModuleVersion $RequiredVersion ` -Graph $dependencyGraph -RedirectMap $redirectMap -Repository $Repository -Credential $Credential -Prerelease:$Prerelease Resolve-DiamondDependencies -Graph $dependencyGraph Write-Verbose "Computing topological order" $topologicalOrder = @(Get-TopologicalOrder -Graph $dependencyGraph) Write-Verbose "Save order ($($topologicalOrder.Count) modules):" for ($i = 0; $i -lt $topologicalOrder.Count; $i++) { Write-Verbose " $($i + 1). $($topologicalOrder[$i])" } # Save modules in topological order foreach ($moduleKey in $topologicalOrder) { $node = $dependencyGraph[$moduleKey] $modName = $node.Name $modVersion = $node.Version # Existing-output detection depends on output format: # -AsNupkg -> $Path/$modName.$modVersion.nupkg # (default) -> $Path/$modName/$modVersion (expanded module folder) if ($AsNupkg) { $expectedPath = Join-Path $resolvedPath.Path "$modName.$modVersion.nupkg" } else { $expectedPath = Join-Path $resolvedPath.Path $modName $modVersion } if (-not (Test-Path $expectedPath)) { Write-Verbose "Saving: $modName version $modVersion" $saveParams = @{ Name = $modName Version = $modVersion Path = $resolvedPath.Path Prerelease = $Prerelease TrustRepository = $true SkipDependencyCheck = $true } if ($AsNupkg) { $saveParams['AsNupkg'] = $true } if ($Repository) { $saveParams['Repository'] = $Repository } if ($Credential) { $saveParams['Credential'] = $Credential } Save-PSResource @saveParams } else { Write-Verbose "Already saved: $modName version $modVersion" } } $mainModuleKey = "${Name}@${RequiredVersion}" $mainNode = $dependencyGraph[$mainModuleKey] Write-Host "Successfully saved $Name version $($mainNode.Version) and dependencies to $resolvedPath" } <# .SYNOPSIS Extracts RequiredModules and ModuleList from a manifest, deduped (RequiredModules wins). NuGet feeds package both as dependencies; reading both keeps the local graph consistent with remote graphs and prevents "assembly already loaded" errors during pre-loading. .OUTPUTS Array of @{ Name; Version } hashtables. #> function Get-ManifestModuleDependencies { param( [Parameter(Mandatory = $true)] [hashtable]$Manifest ) $hasRequired = $Manifest.ContainsKey('RequiredModules') -and $Manifest.RequiredModules -and $Manifest.RequiredModules.Count -gt 0 $hasModuleList = $Manifest.ContainsKey('ModuleList') -and $Manifest.ModuleList -and $Manifest.ModuleList.Count -gt 0 if (-not $hasRequired -and -not $hasModuleList) { return @() } # Parse a single manifest entry into @{ Name; Version } function ParseEntry { param([object]$Entry, [string]$Source) if ($Entry -is [string]) { throw "$Source entry '$Entry' has no version. All entries must specify a version (RequiredVersion or ModuleVersion)." } elseif ($Entry -is [hashtable]) { $name = if ($Entry.ContainsKey('ModuleName')) { $Entry.ModuleName } else { $null } if (-not $name) { throw "$Source entry has no module name: $($Entry | ConvertTo-Json -Compress)" } $version = $null if ($Entry.ContainsKey('RequiredVersion')) { $version = $Entry.RequiredVersion.ToString() } elseif ($Entry.ContainsKey('ModuleVersion')) { $version = "[$($Entry.ModuleVersion), )" } if (-not $version) { throw "$Source entry '$name' has no version. All entries must specify a version (RequiredVersion or ModuleVersion)." } return @{ Name = $name; Version = $version } } else { throw "Unrecognized $Source format in manifest: $Entry. Expected string or hashtable." } } # RequiredModules take precedence $seen = @{} $results = [System.Collections.ArrayList]@() if ($hasRequired) { Write-Verbose "Found $($Manifest.RequiredModules.Count) module(s) in RequiredModules" foreach ($entry in $Manifest.RequiredModules) { $parsed = ParseEntry -Entry $entry -Source 'RequiredModules' $key = $parsed.Name.ToLowerInvariant() if (-not $seen.ContainsKey($key)) { $seen[$key] = $true [void]$results.Add($parsed) } } } if ($hasModuleList) { Write-Verbose "Found $($Manifest.ModuleList.Count) module(s) in ModuleList" foreach ($entry in $Manifest.ModuleList) { $parsed = ParseEntry -Entry $entry -Source 'ModuleList' $key = $parsed.Name.ToLowerInvariant() if (-not $seen.ContainsKey($key)) { $seen[$key] = $true [void]$results.Add($parsed) } else { Write-Verbose "Skipping ModuleList entry '$($parsed.Name)' — already declared in RequiredModules" } } } return $results.ToArray() } function Find-PSResourceDependencies { <# .SYNOPSIS Resolves all dependencies (RequiredModules + ModuleList) from a .psd1 manifest via remote repository. .EXAMPLE Find-PSResourceDependencies -ManifestPath "./MyModule/MyModule.psd1" .OUTPUTS Array of PSCustomObject with Name, Version, Repository, and IsRedirected properties. #> [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$ManifestPath, [Parameter(Mandatory = $false)] [string]$RedirectMapPath, [Parameter(Mandatory = $false)] [string]$Repository, [Parameter(Mandatory = $false)] [PSCredential]$Credential, [Parameter(Mandatory = $false)] [switch]$Prerelease ) if (-not (Test-Path $ManifestPath)) { throw "Manifest file not found: $ManifestPath" } $resolvedPath = Resolve-Path $ManifestPath if (-not $resolvedPath.Path.EndsWith('.psd1')) { throw "File must be a PowerShell module manifest (.psd1): $ManifestPath" } Write-Verbose "Reading manifest from: $resolvedPath" $manifest = Import-PowerShellDataFile -Path $resolvedPath $moduleDependencies = @(Get-ManifestModuleDependencies -Manifest $manifest) if ($moduleDependencies.Count -eq 0) { Write-Verbose "No module dependencies found in manifest (RequiredModules or ModuleList)" return @() } $manifestModuleName = [System.IO.Path]::GetFileNameWithoutExtension($resolvedPath.Path) $manifestModuleVersion = if ($manifest.ModuleVersion) { $manifest.ModuleVersion.ToString() } else { "" } if ($RedirectMapPath) { if (-not (Test-Path $RedirectMapPath)) { throw "Redirect map file not found: $RedirectMapPath" } Write-Verbose "Loading redirect map from: $RedirectMapPath" $redirectMap = Get-Content $RedirectMapPath -Raw | ConvertFrom-Json -AsHashtable } else { Write-Verbose "Looking for redirect map based on manifest: $manifestModuleName version $manifestModuleVersion" $redirectMap = Get-MergedRedirectMap -OuterMap $script:defaultRedirectMap -Name $manifestModuleName -Version $manifestModuleVersion } Write-Verbose "Found $($moduleDependencies.Count) module dependency(ies) in manifest" $dependencyGraph = @{} foreach ($depEntry in $moduleDependencies) { $moduleName = $depEntry.Name $moduleVersion = $depEntry.Version $mergedRedirectMap = Get-MergedRedirectMap -OuterMap $redirectMap -Name $moduleName -Version ($moduleVersion ?? "") $redirectResult = Find-DependencyRedirect -DependencyName $moduleName -DependencyVersion $moduleVersion ` -RedirectMap $mergedRedirectMap -Indent "" Build-RemoteDependencyGraph -ModuleName $redirectResult.ResolvedName -ModuleVersion $redirectResult.ResolvedVersion ` -Graph $dependencyGraph -RedirectMap $mergedRedirectMap -Repository $Repository -Credential $Credential -Prerelease:$Prerelease } Resolve-DiamondDependencies -Graph $dependencyGraph $topologicalOrder = @(Get-TopologicalOrder -Graph $dependencyGraph) $resolvedDependencies = [System.Collections.ArrayList]@() foreach ($moduleKey in $topologicalOrder) { $node = $dependencyGraph[$moduleKey] [void]$resolvedDependencies.Add([PSCustomObject]@{ Name = $node.Name Version = $node.Version Repository = $node.Repository IsRedirected = $false # Graph already has redirected versions applied }) } Write-Verbose "Resolved $($resolvedDependencies.Count) module(s) (including transitive dependencies)" return $resolvedDependencies.ToArray() } function Install-PSResourceDependencies { <# .SYNOPSIS Installs all manifest dependencies using Find-PSResourceDependencies. .EXAMPLE Install-PSResourceDependencies -ManifestPath "./MyModule/MyModule.psd1" #> [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$ManifestPath, [Parameter(Mandatory = $false)] [string]$RedirectMapPath, [Parameter(Mandatory = $false)] [ValidateSet('CurrentUser', 'AllUsers')] [string]$Scope = 'CurrentUser', [Parameter(Mandatory = $false)] [string]$Repository, [Parameter(Mandatory = $false)] [PSCredential]$Credential, [Parameter(Mandatory = $false)] [switch]$Force ) $findParams = @{ ManifestPath = $ManifestPath } if ($RedirectMapPath) { $findParams['RedirectMapPath'] = $RedirectMapPath } if ($Repository) { $findParams['Repository'] = $Repository } if ($Credential) { $findParams['Credential'] = $Credential } $resolvedDependencies = Find-PSResourceDependencies @findParams if (-not $resolvedDependencies -or $resolvedDependencies.Count -eq 0) { Write-Verbose "No dependencies to install" return } Write-Verbose "Installing $($resolvedDependencies.Count) resolved dependency(ies)" foreach ($dependency in $resolvedDependencies) { $installed = $null if (-not $Force) { $installed = Get-PSResource -Name $dependency.Name -ErrorAction SilentlyContinue | Where-Object { $_.Version.ToString() -eq $dependency.Version } } if (-not $installed) { Write-Host "Installing dependency: $($dependency.Name) version $($dependency.Version)" $installParams = @{ Name = $dependency.Name Version = $dependency.Version Scope = $Scope TrustRepository = $true SkipDependencyCheck = $true } if ($Repository) { $installParams['Repository'] = $Repository } if ($Credential) { $installParams['Credential'] = $Credential } if ($Force) { $installParams['Reinstall'] = $true } Install-PSResource @installParams } else { Write-Verbose "Already installed: $($dependency.Name) version $($dependency.Version)" } } Write-Host "Successfully installed all dependencies from manifest" } function Import-PSResourceDependencies { <# .SYNOPSIS Imports all manifest dependencies (RequiredModules + ModuleList) in topological order with pinned versions. Prevents "assembly already loaded" errors from incomplete graphs. .EXAMPLE Import-PSResourceDependencies -ManifestPath "./MyModule/MyModule.psd1" #> [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$ManifestPath, [Parameter(Mandatory = $false)] [string]$RedirectMapPath, [Parameter(Mandatory = $false)] [switch]$Force, [Parameter(Mandatory = $false)] [switch]$PassThru ) # Validate manifest path if (-not (Test-Path $ManifestPath)) { throw "Manifest file not found: $ManifestPath" } $resolvedPath = Resolve-Path $ManifestPath if (-not $resolvedPath.Path.EndsWith('.psd1')) { throw "File must be a PowerShell module manifest (.psd1): $ManifestPath" } Write-Verbose "Reading manifest from: $resolvedPath" # Parse the manifest $manifest = Import-PowerShellDataFile -Path $resolvedPath # Extract module dependencies from both RequiredModules and ModuleList $moduleDependencies = @(Get-ManifestModuleDependencies -Manifest $manifest) if ($moduleDependencies.Count -eq 0) { Write-Verbose "No module dependencies found in manifest (RequiredModules or ModuleList)" return } $manifestModuleName = [System.IO.Path]::GetFileNameWithoutExtension($resolvedPath.Path) $manifestModuleVersion = if ($manifest.ModuleVersion) { $manifest.ModuleVersion.ToString() } else { "" } if ($RedirectMapPath) { if (-not (Test-Path $RedirectMapPath)) { throw "Redirect map file not found: $RedirectMapPath" } Write-Verbose "Loading redirect map from: $RedirectMapPath" $redirectMap = Get-Content $RedirectMapPath -Raw | ConvertFrom-Json -AsHashtable } else { Write-Verbose "Looking for redirect map based on manifest: $manifestModuleName version $manifestModuleVersion" $redirectMap = Get-MergedRedirectMap -OuterMap $script:defaultRedirectMap -Name $manifestModuleName -Version $manifestModuleVersion } Write-Verbose "Found $($moduleDependencies.Count) module dependency(ies) in manifest" $dependencyGraph = @{} foreach ($depEntry in $moduleDependencies) { $moduleName = $depEntry.Name $moduleVersion = $depEntry.Version $mergedRedirectMap = Get-MergedRedirectMap -OuterMap $redirectMap -Name $moduleName -Version ($moduleVersion ?? "") $redirectResult = Find-DependencyRedirect -DependencyName $moduleName -DependencyVersion $moduleVersion ` -RedirectMap $mergedRedirectMap -Indent "" Build-InstalledDependencyGraph -ModuleName $redirectResult.ResolvedName -ModuleVersion $redirectResult.ResolvedVersion ` -Graph $dependencyGraph -RedirectMap $mergedRedirectMap } Resolve-DiamondDependencies -Graph $dependencyGraph # Compute topological order Write-Verbose "Computing topological order" $topologicalOrder = @(Get-TopologicalOrder -Graph $dependencyGraph) Write-Verbose "Import order ($($topologicalOrder.Count) modules):" for ($i = 0; $i -lt $topologicalOrder.Count; $i++) { Write-Verbose " $($i + 1). $($topologicalOrder[$i])" } Write-Verbose "Pre-loading all modules in topological order" $importedModules = @{} foreach ($moduleKey in $topologicalOrder) { $node = $dependencyGraph[$moduleKey] $modName = $node.Name $modVersion = $node.Version $loadedModule = Get-Module -Name $modName | Where-Object { $_.Version.ToString() -eq $modVersion } if ($loadedModule -and -not $Force) { Write-Verbose "Already loaded: $modName version $modVersion" $importedModules[$moduleKey] = $loadedModule continue } # -Global ensures modules persist after this function returns $importParams = @{ Name = $modName RequiredVersion = $modVersion ErrorAction = 'Stop' DisableNameChecking = $true Global = $true } if ($Force) { $importParams['Force'] = $true } try { Write-Verbose "Importing: $modName version $modVersion" $imported = Import-Module @importParams -PassThru $importedModules[$moduleKey] = $imported } catch { throw "Failed to import $modName version $($modVersion): $_" } } Write-Verbose "Successfully imported $($importedModules.Count) module(s) from manifest" if ($PassThru) { return $importedModules.Values } } function Import-ModulePinned { <# .SYNOPSIS Imports a module after pre-loading ALL transitive dependencies at exact versions. Prevents PowerShell from loading wrong versions via minimum-version semantics. .EXAMPLE Import-ModulePinned -Name "VMware.PowerCLI" -RequiredVersion "13.3.0" #> [CmdletBinding()] param( [Parameter(Mandatory = $true, Position = 0)] [string]$Name, [Parameter(Mandatory = $true, Position = 1)] [string]$RequiredVersion, [Parameter(Mandatory = $false)] [string]$RedirectMapPath, [Parameter(Mandatory = $false)] [switch]$Force, [Parameter(Mandatory = $false)] [string]$Prefix, [Parameter(Mandatory = $false)] [switch]$PassThru ) # Load redirect map if ($RedirectMapPath) { if (-not (Test-Path $RedirectMapPath)) { throw "Redirect map file not found: $RedirectMapPath" } Write-Verbose "Loading redirect map from: $RedirectMapPath" $redirectMap = Get-Content $RedirectMapPath -Raw | ConvertFrom-Json -AsHashtable } else { Write-Verbose "Using default redirect map" $redirectMap = $script:defaultRedirectMap } $redirectMap = Get-MergedRedirectMap -OuterMap $redirectMap -Name $Name -Version $RequiredVersion Write-Verbose "Building dependency graph for $Name version $RequiredVersion" $dependencyGraph = @{} Build-InstalledDependencyGraph -ModuleName $Name -ModuleVersion $RequiredVersion ` -Graph $dependencyGraph -RedirectMap $redirectMap Resolve-DiamondDependencies -Graph $dependencyGraph Write-Verbose "Dependency graph contains $($dependencyGraph.Count) modules:" foreach ($nodeKey in $dependencyGraph.Keys | Sort-Object) { $node = $dependencyGraph[$nodeKey] Write-Verbose " $nodeKey" Write-Verbose " Location: $($node.InstalledLocation)" if ($node.Dependencies.Count -gt 0) { Write-Verbose " Dependencies:" foreach ($dep in $node.Dependencies) { Write-Verbose " -> $dep" } } else { Write-Verbose " Dependencies: (none)" } } # Compute topological order Write-Verbose "Computing topological order" $topologicalOrder = @(Get-TopologicalOrder -Graph $dependencyGraph) Write-Verbose "Import order ($($topologicalOrder.Count) modules):" for ($i = 0; $i -lt $topologicalOrder.Count; $i++) { Write-Verbose " $($i + 1). $($topologicalOrder[$i])" } Write-Verbose "Pre-loading all modules in topological order" $importedModules = @{} foreach ($moduleKey in $topologicalOrder) { $node = $dependencyGraph[$moduleKey] $modName = $node.Name $modVersion = $node.Version $loadedModule = Get-Module -Name $modName | Where-Object { $_.Version.ToString() -eq $modVersion } if ($loadedModule -and -not $Force) { Write-Verbose "Already loaded: $modName version $modVersion" $importedModules[$moduleKey] = $loadedModule continue } # -Global ensures modules persist after this function returns $importParams = @{ Name = $modName RequiredVersion = $modVersion ErrorAction = 'Stop' DisableNameChecking = $true Global = $true } if ($Force) { $importParams['Force'] = $true } try { Write-Verbose "Importing: $modName version $modVersion" $imported = Import-Module @importParams -PassThru $importedModules[$moduleKey] = $imported } catch { throw "Failed to import $modName version $($modVersion): $_" } } Write-Verbose "Returning main module" $mainModuleKey = "${Name}@${RequiredVersion}" $mainModule = $importedModules[$mainModuleKey] if (-not $mainModule) { $mainModule = Get-Module -Name $Name | Where-Object { $_.Version.ToString() -eq $RequiredVersion } } Write-Verbose "Successfully imported $Name version $RequiredVersion (and $($importedModules.Count - 1) dependencies)" if ($PassThru) { return $mainModule } } function Find-PSResourcesPinned { <# .SYNOPSIS Resolves a module and all dependencies with pinned versions. Returns results in topological order. .EXAMPLE Find-PSResourcesPinned -Name "VMware.PowerCLI" -RequiredVersion "13.3.0" .OUTPUTS Array of objects with Name, Version, Repository, and Dependencies properties. #> [CmdletBinding()] param( [Parameter(Mandatory = $true)] [string]$Name, [Parameter(Mandatory = $true)] [string]$RequiredVersion, [Parameter(Mandatory = $false)] [string]$RedirectMapPath, [Parameter(Mandatory = $false)] [string]$Repository, [Parameter(Mandatory = $false)] [PSCredential]$Credential, [Parameter(Mandatory = $false)] [switch]$Prerelease ) # Load redirect map if ($RedirectMapPath) { if (-not (Test-Path $RedirectMapPath)) { throw "Redirect map file not found: $RedirectMapPath" } Write-Verbose "Loading redirect map from: $RedirectMapPath" $redirectMap = Get-Content $RedirectMapPath -Raw | ConvertFrom-Json -AsHashtable } else { Write-Verbose "Using default redirect map" $redirectMap = $script:defaultRedirectMap } $redirectMap = Get-MergedRedirectMap -OuterMap $redirectMap -Name $Name -Version $RequiredVersion Write-Verbose "Building dependency graph for $Name version $RequiredVersion" $dependencyGraph = @{} Build-RemoteDependencyGraph -ModuleName $Name -ModuleVersion $RequiredVersion ` -Graph $dependencyGraph -RedirectMap $redirectMap -Repository $Repository -Credential $Credential -Prerelease:$Prerelease Resolve-DiamondDependencies -Graph $dependencyGraph Write-Verbose "Computing topological order" $topologicalOrder = @(Get-TopologicalOrder -Graph $dependencyGraph) $resolvedModules = [System.Collections.ArrayList]@() foreach ($moduleKey in $topologicalOrder) { $node = $dependencyGraph[$moduleKey] [void]$resolvedModules.Add([PSCustomObject]@{ Name = $node.Name Version = $node.Version Repository = $node.Repository Dependencies = $node.Dependencies }) } Write-Verbose "Found $($resolvedModules.Count) module(s) (including main module and all dependencies)" return $resolvedModules.ToArray() } # SIG # Begin signature block # MIInSQYJKoZIhvcNAQcCoIInOjCCJzYCAQExDzANBglghkgBZQMEAgEFADB5Bgor # BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG # KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCClPUYI3amuSDUy # 5Qku568MOQ61BfA/2vvnfH+KzZ54fKCCDLowggX1MIID3aADAgECAhMzAAACHU0Z # 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 # 1cY2L4A7GTQG1h32HHAvfQESWP0xghnlMIIZ4QIBATBuMFcxCzAJBgNVBAYTAlVT # MR4wHAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xKDAmBgNVBAMTH01pY3Jv # c29mdCBDb2RlIFNpZ25pbmcgUENBIDIwMjQCEzMAAAIdTRnITtcPV0gAAAAAAh0w # DQYJYIZIAWUDBAIBBQCgga4wGQYJKoZIhvcNAQkDMQwGCisGAQQBgjcCAQQwHAYK # KwYBBAGCNwIBCzEOMAwGCisGAQQBgjcCARUwLwYJKoZIhvcNAQkEMSIEIDYKto4b # hQZFVWLCB2PEp4wQCmp8kBp26HqVegSZIl1pMEIGCisGAQQBgjcCAQwxNDAyoBSA # EgBNAGkAYwByAG8AcwBvAGYAdKEagBhodHRwOi8vd3d3Lm1pY3Jvc29mdC5jb20w # DQYJKoZIhvcNAQEBBQAEggEAciHwHh9XAhh/Y7V5PQR+Rb+BikE0DzU0jBSf5QRs # 6RY8P9bCL/8mSLHl984imT0D4s0XdJKHaPgbmotz75+c0+IayW2+fitc+E3yvM3o # DnADgcyEZOYXu88hqt4uV0xqJthHNwCWq9uw1owfgF76HOq78Jwmnhi2k3UtGJXE # JjxiVRWH6z+GsP4kR1cL/HzEpq/IswZm6Ilm7A1xVUmVTBYm24ByXyVaVsbSkB8i # 6UzHEcuGy6OAwjOQbiF3cSw+5tZdEgcR69sMXyRft5/9z+YawQoDYYV9aSeSPeM3 # mIbFaDrZc8ghcus8szt7b0TClh452crKmXov+LtOe4kgFKGCF5cwgheTBgorBgEE # AYI3AwMBMYIXgzCCF38GCSqGSIb3DQEHAqCCF3AwghdsAgEDMQ8wDQYJYIZIAWUD # BAIBBQAwggFSBgsqhkiG9w0BCRABBKCCAUEEggE9MIIBOQIBAQYKKwYBBAGEWQoD # ATAxMA0GCWCGSAFlAwQCAQUABCA40Xp5Rq9QcYnAnw/re3BD3YA43bdhBrlJKEJC # WLjbJwIGagzcqeJsGBMyMDI2MDUyNjIwMzMyNi45MDRaMASAAgH0oIHRpIHOMIHL # MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVk # bW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxN # aWNyb3NvZnQgQW1lcmljYSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRT # UyBFU046OTYwMC0wNUUwLUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0 # YW1wIFNlcnZpY2WgghHtMIIHIDCCBQigAwIBAgITMwAAAiY1tD5nQ5P2HwABAAAC # JjANBgkqhkiG9w0BAQsFADB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGlu # Z3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBv # cmF0aW9uMSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMDAe # Fw0yNjAyMTkxOTQwMDJaFw0yNzA1MTcxOTQwMDJaMIHLMQswCQYDVQQGEwJVUzET # MBEGA1UECBMKV2FzaGluZ3RvbjEQMA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMV # TWljcm9zb2Z0IENvcnBvcmF0aW9uMSUwIwYDVQQLExxNaWNyb3NvZnQgQW1lcmlj # YSBPcGVyYXRpb25zMScwJQYDVQQLEx5uU2hpZWxkIFRTUyBFU046OTYwMC0wNUUw # LUQ5NDcxJTAjBgNVBAMTHE1pY3Jvc29mdCBUaW1lLVN0YW1wIFNlcnZpY2UwggIi # MA0GCSqGSIb3DQEBAQUAA4ICDwAwggIKAoICAQC//w+ZZIL5RFFpVI8D3ZyuNu8I # zcAEOD30OLYjh337rXjcrIlOSzpJc4ZeUxEyli6x6F6zm4NR8dbPb9diDp/hOUzH # WGxiA1Z3RXKBb/4F/ojyvN43SEGWqSfVc3I3BlsYT35ecVAJ9kVf90YOv29tFjJB # BZkYvrT/DwwyRLscOyP4p+9/lyJjD+ULs3YXBhVrfZ+MbQB+BYKLqRvBKbj/wR9a # kNrMxQINoGaD5jZO/N/nSsmG2P1zv/cv4gSoMBnWeQIBkjd2I5w1DeXupp2vSiNm # R5sA2ZkBK3yiQWaJvRxODlkfiyHk9Mkk/TrYTjmjPCbhe+uqhHNRy8UlbOvWsCq0 # tRtUykHv39DgqAfJNrE8OSt835rBzDprrcAhwmgfhoVi4AKeqwikY0nUa48K0Qy8 # 0XT4fiEA3ExEZNaRFo9Nq/GwbfgqKqGmc9xhKuRFcjtua4KHZvnAvpWgEFSOCkov # Xs/BcLnkEHM9xZ8iUag5CyhNqXYYE/z0pcXdYaNIkQ68EWmuvLm7g9oofV2vOm5G # VNoghnkWG6nGPo/JwEgmA9oSS0EfvFRMWPA/gpSvF3shArKHnaEpVSSi3DNbyiuY # iEs9Ko0IkZc8xKFeQRaqGRxrB+2r/7B3X81Tps99KhFwg+wD87od22F2MUg1x7tw # t3gaVnFk0IZIwUPCGwIDAQABo4IBSTCCAUUwHQYDVR0OBBYEFF3hn9fYJN2Y/Z9L # VbBPIxAzXHsQMB8GA1UdIwQYMBaAFJ+nFV0AXmJdg/Tl0mWnG1M1GelyMF8GA1Ud # HwRYMFYwVKBSoFCGTmh0dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvY3Js # L01pY3Jvc29mdCUyMFRpbWUtU3RhbXAlMjBQQ0ElMjAyMDEwKDEpLmNybDBsBggr # BgEFBQcBAQRgMF4wXAYIKwYBBQUHMAKGUGh0dHA6Ly93d3cubWljcm9zb2Z0LmNv # bS9wa2lvcHMvY2VydHMvTWljcm9zb2Z0JTIwVGltZS1TdGFtcCUyMFBDQSUyMDIw # MTAoMSkuY3J0MAwGA1UdEwEB/wQCMAAwFgYDVR0lAQH/BAwwCgYIKwYBBQUHAwgw # DgYDVR0PAQH/BAQDAgeAMA0GCSqGSIb3DQEBCwUAA4ICAQA2Ux0tr9sYCjsq0FRy # iVpx15OurNXv6Qk7iX+ArVPlz3w4tqjcTNm1dt3tTua2wJMpJhPH8n7UXhmT98d5 # Du44Ll4adnse4SQfVg3QL6aRkXHnJUn8y9iftB/Py22n9xnwPFfj3QlDOSgLuHle # u97U0iH2ZaluYabWXJihdiYpK8cPHFlqZOAiot0+GD8dP+RMuvpxt/F2LmYelpoZ # wriiFOUmlxEUV7xJHyZZlDquskeyuq01DTv91N4qM8cfPPhl/2pc4HeMf/nd2Hou # ifJbDQFNd4WPhLzn0Sy3u1Zh3+S3tjQdqN+dyw60RaV+RXCoOLgFZ3MAg/GoDl+f # vb5hy/1a71ctX8wEad1Pf6def2pqfl3wFc++hkF8DXXTZofJN4YVaN3InwbAGQDD # kNK4lqecCixxmSKwidPynGeE5OtvNoK1pkLsm/i8F1RjGczZ/kSF2VDkqG866iQ+ # jVbGOQ6Du3eyyFcFKZoDJ4B5mEAS9aT2SKqllLeybOboH6r67siR5B/2Hnu7+KYu # YZy0BEadtA6ngG4cnSR9JsrkhhsKmb11ujqwgJyNx92MsoGGwNgN1aI0QID8CsjC # FwpfmMzlA44xHKYv3hmjxeqBS4uU5rQeiAnVgpJeaVGKm/lzPDtnppGV+7XhRp5b # 1ZxT/Z7Xxc+I7H7/jCtQDZoaZTCCB3EwggVZoAMCAQICEzMAAAAVxedrngKbSZkA # AAAAABUwDQYJKoZIhvcNAQELBQAwgYgxCzAJBgNVBAYTAlVTMRMwEQYDVQQIEwpX # YXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4wHAYDVQQKExVNaWNyb3NvZnQg # Q29ycG9yYXRpb24xMjAwBgNVBAMTKU1pY3Jvc29mdCBSb290IENlcnRpZmljYXRl # IEF1dGhvcml0eSAyMDEwMB4XDTIxMDkzMDE4MjIyNVoXDTMwMDkzMDE4MzIyNVow # fDELMAkGA1UEBhMCVVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1Jl # ZG1vbmQxHjAcBgNVBAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMd # TWljcm9zb2Z0IFRpbWUtU3RhbXAgUENBIDIwMTAwggIiMA0GCSqGSIb3DQEBAQUA # A4ICDwAwggIKAoICAQDk4aZM57RyIQt5osvXJHm9DtWC0/3unAcH0qlsTnXIyjVX # 9gF/bErg4r25PhdgM/9cT8dm95VTcVrifkpa/rg2Z4VGIwy1jRPPdzLAEBjoYH1q # UoNEt6aORmsHFPPFdvWGUNzBRMhxXFExN6AKOG6N7dcP2CZTfDlhAnrEqv1yaa8d # q6z2Nr41JmTamDu6GnszrYBbfowQHJ1S/rboYiXcag/PXfT+jlPP1uyFVk3v3byN # pOORj7I5LFGc6XBpDco2LXCOMcg1KL3jtIckw+DJj361VI/c+gVVmG1oO5pGve2k # rnopN6zL64NF50ZuyjLVwIYwXE8s4mKyzbnijYjklqwBSru+cakXW2dg3viSkR4d # Pf0gz3N9QZpGdc3EXzTdEonW/aUgfX782Z5F37ZyL9t9X4C626p+Nuw2TPYrbqgS # Uei/BQOj0XOmTTd0lBw0gg/wEPK3Rxjtp+iZfD9M269ewvPV2HM9Q07BMzlMjgK8 # QmguEOqEUUbi0b1qGFphAXPKZ6Je1yh2AuIzGHLXpyDwwvoSCtdjbwzJNmSLW6Cm # gyFdXzB0kZSU2LlQ+QuJYfM2BjUYhEfb3BvR/bLUHMVr9lxSUV0S2yW6r1AFemzF # ER1y7435UsSFF5PAPBXbGjfHCBUYP3irRbb1Hode2o+eFnJpxq57t7c+auIurQID # AQABo4IB3TCCAdkwEgYJKwYBBAGCNxUBBAUCAwEAATAjBgkrBgEEAYI3FQIEFgQU # KqdS/mTEmr6CkTxGNSnPEP8vBO4wHQYDVR0OBBYEFJ+nFV0AXmJdg/Tl0mWnG1M1 # GelyMFwGA1UdIARVMFMwUQYMKwYBBAGCN0yDfQEBMEEwPwYIKwYBBQUHAgEWM2h0 # dHA6Ly93d3cubWljcm9zb2Z0LmNvbS9wa2lvcHMvRG9jcy9SZXBvc2l0b3J5Lmh0 # bTATBgNVHSUEDDAKBggrBgEFBQcDCDAZBgkrBgEEAYI3FAIEDB4KAFMAdQBiAEMA # QTALBgNVHQ8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAfBgNVHSMEGDAWgBTV9lbL # j+iiXGJo0T2UkFvXzpoYxDBWBgNVHR8ETzBNMEugSaBHhkVodHRwOi8vY3JsLm1p # Y3Jvc29mdC5jb20vcGtpL2NybC9wcm9kdWN0cy9NaWNSb29DZXJBdXRfMjAxMC0w # Ni0yMy5jcmwwWgYIKwYBBQUHAQEETjBMMEoGCCsGAQUFBzAChj5odHRwOi8vd3d3 # Lm1pY3Jvc29mdC5jb20vcGtpL2NlcnRzL01pY1Jvb0NlckF1dF8yMDEwLTA2LTIz # LmNydDANBgkqhkiG9w0BAQsFAAOCAgEAnVV9/Cqt4SwfZwExJFvhnnJL/Klv6lwU # tj5OR2R4sQaTlz0xM7U518JxNj/aZGx80HU5bbsPMeTCj/ts0aGUGCLu6WZnOlNN # 3Zi6th542DYunKmCVgADsAW+iehp4LoJ7nvfam++Kctu2D9IdQHZGN5tggz1bSNU # 5HhTdSRXud2f8449xvNo32X2pFaq95W2KFUn0CS9QKC/GbYSEhFdPSfgQJY4rPf5 # KYnDvBewVIVCs/wMnosZiefwC2qBwoEZQhlSdYo2wh3DYXMuLGt7bj8sCXgU6ZGy # qVvfSaN0DLzskYDSPeZKPmY7T7uG+jIa2Zb0j/aRAfbOxnT99kxybxCrdTDFNLB6 # 2FD+CljdQDzHVG2dY3RILLFORy3BFARxv2T5JL5zbcqOCb2zAVdJVGTZc9d/HltE # AY5aGZFrDZ+kKNxnGSgkujhLmm77IVRrakURR6nxt67I6IleT53S0Ex2tVdUCbFp # AUR+fKFhbHP+CrvsQWY9af3LwUFJfn6Tvsv4O+S3Fb+0zj6lMVGEvL8CwYKiexcd # FYmNcP7ntdAoGokLjzbaukz5m/8K6TT4JDVnK+ANuOaMmdbhIurwJ0I9JZTmdHRb # atGePu1+oDEzfbzL6Xu/OHBE0ZDxyKs6ijoIYn/ZcGNTTY3ugm2lBRDBcQZqELQd # VTNYs6FwZvKhggNQMIICOAIBATCB+aGB0aSBzjCByzELMAkGA1UEBhMCVVMxEzAR # BgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNVBAoTFU1p # Y3Jvc29mdCBDb3Jwb3JhdGlvbjElMCMGA1UECxMcTWljcm9zb2Z0IEFtZXJpY2Eg # T3BlcmF0aW9uczEnMCUGA1UECxMeblNoaWVsZCBUU1MgRVNOOjk2MDAtMDVFMC1E # OTQ3MSUwIwYDVQQDExxNaWNyb3NvZnQgVGltZS1TdGFtcCBTZXJ2aWNloiMKAQEw # BwYFKw4DAhoDFQCi/fMxFtkqr7XMXdsRyWU0lSKHZ6CBgzCBgKR+MHwxCzAJBgNV # BAYTAlVTMRMwEQYDVQQIEwpXYXNoaW5ndG9uMRAwDgYDVQQHEwdSZWRtb25kMR4w # HAYDVQQKExVNaWNyb3NvZnQgQ29ycG9yYXRpb24xJjAkBgNVBAMTHU1pY3Jvc29m # dCBUaW1lLVN0YW1wIFBDQSAyMDEwMA0GCSqGSIb3DQEBCwUAAgUA7b/rbDAiGA8y # MDI2MDUyNjA5NTAzNloYDzIwMjYwNTI3MDk1MDM2WjB3MD0GCisGAQQBhFkKBAEx # LzAtMAoCBQDtv+tsAgEAMAoCAQACAhfNAgH/MAcCAQACAhTTMAoCBQDtwTzsAgEA # MDYGCisGAQQBhFkKBAIxKDAmMAwGCisGAQQBhFkKAwKgCjAIAgEAAgMHoSChCjAI # AgEAAgMBhqAwDQYJKoZIhvcNAQELBQADggEBAFEuYOvWQNJzNKTTsLcwSN2+sfpQ # ices/CNCOb5s0diFuiGzQ6pMlb6mcd7bhoqwh+dEqbgfDwPlu7aKahiMLFIDdteX # biP/BhPO6Rxcr4MdP7bgN5TDeieIAHJWilBj9DGgMaqSzEvhfI2GglRJ91PRZrhh # GZVEzCPbrebH4/PuJYiqSGytIqVbnal0OYUDPbzzA6+uTh1wTj4i78NeDoLzurVD # KKsGOhHH+0T4pJiixbPbpsYny0ispxwL7gB0E3+0q4poVSKtXNoPHHiFHbMhnvsE # lv6cCh6v54wHVo0HiOtYIdREum4Qr3GT0cWHDdygIirkpSyej8+rp9ULTzExggQN # MIIECQIBATCBkzB8MQswCQYDVQQGEwJVUzETMBEGA1UECBMKV2FzaGluZ3RvbjEQ # MA4GA1UEBxMHUmVkbW9uZDEeMBwGA1UEChMVTWljcm9zb2Z0IENvcnBvcmF0aW9u # MSYwJAYDVQQDEx1NaWNyb3NvZnQgVGltZS1TdGFtcCBQQ0EgMjAxMAITMwAAAiY1 # tD5nQ5P2HwABAAACJjANBglghkgBZQMEAgEFAKCCAUowGgYJKoZIhvcNAQkDMQ0G # CyqGSIb3DQEJEAEEMC8GCSqGSIb3DQEJBDEiBCB0M8GEYbd+WnweQzqcABpsoE0r # 1f/ujIt44PYUP6eT9TCB+gYLKoZIhvcNAQkQAi8xgeowgecwgeQwgb0EIMwyXGFn # TNsZRBrs6GN/BbV0okaNP3VBYqLFjUsFnbgqMIGYMIGApH4wfDELMAkGA1UEBhMC # VVMxEzARBgNVBAgTCldhc2hpbmd0b24xEDAOBgNVBAcTB1JlZG1vbmQxHjAcBgNV # BAoTFU1pY3Jvc29mdCBDb3Jwb3JhdGlvbjEmMCQGA1UEAxMdTWljcm9zb2Z0IFRp # bWUtU3RhbXAgUENBIDIwMTACEzMAAAImNbQ+Z0OT9h8AAQAAAiYwIgQg0Ix/js8D # 6pu4mx3z/iH8x0+DjTWjcknPcO92927cDewwDQYJKoZIhvcNAQELBQAEggIAnv7e # 8eHnvPFAgCPZ9lCm+Gpno1HC9Tswj/klgj2XWImUaVKxHXiSZX7zG2wRUUQNqTUa # 0vq9fgWhB9vjC7s5QrV+pHgyMeMe2mzu91J7WeycZfJ2sUCr/dbjCX4q2DuxSYmG # +jJuxCHHF129KdFpB/jyAoOkBzJD8GXGEnDzlN3y4uiWFdV0Tz7S8L4sP+euLk9p # DQqn9D8/f0LY35ZG9ijLreqE2p4qRwWJp00AbCm3NzIpkPpRNrsJOvsnCL/LXYBc # uJvFpk6g7stgR/KiT0dixxaLe6q2Y0mmHANPuo01lMoZbnAXsAPq1L72wNISNV0i # h8KSkyi+2f2fp/ck0xHdcqhmz6+V1tZEGV55vu5TGV6PJT/78lteOSIaST6Mh6h8 # HM1anUI1pRuIFO6yw1OT1m31kE6vTzvclD+89NeoR9HAiR2znjRpUlAi+zGETHbp # C3fsk9PxwO9j++o2JyiSJ1yT3YpxuF6mjLPA/8hte3TQwf5z/8LT1vPZ+KNuqJIX # 8NMRH9RU8U2ptBEE07lnXzHWqxErfKw5P6hMLSvjO79TvUrWCwtUtjsY+KThqU70 # veaJNMlmErGYa1FCJ0pxv3hc1qK+RTYBHZ/IArcGfn+DGq1ECsuh6OKGqvWikJ5J # dz6aRTFZdXxxGAQikCoD96xCh2UbIkOha4hGfMk= # SIG # End signature block |