🩹 [Patch]: Bump Context and Sodium to latest versions

examples/Apps/Get-WebhookDelivery.ps1

@@ -26,7 +26,7 @@ $deliveries | Where-Object { $_.Event -eq 'team' } | Format-Table -AutoSize
 
 $Return.Response | Format-Table -AutoSize
 
-Set-GitHubDefaultContext -Context 'msx.ghe.com/Marius-Storhaug'
+Switch-GitHubContext -Context 'msx.ghe.com/Marius-Storhaug'
 
 1..10 | ForEach-Object {
     New-GitHubTeam -Organization 'my-org' -Name "Test$_"

examples/Connecting.ps1

@@ -1,6 +1,4 @@
-#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '7.0.2' }
-
-###
+###
 ### CONNECTING
 ###
 
@@ -40,16 +38,15 @@ Get-GitHubContext -ListAvailable
 Get-GitHubContext -Context 'msx.ghe.com/MariusStorhaug'
 
 # Take a name dynamically from Get-GitHubContext? Autocomplete the name
-Set-GitHubDefaultContext -Context 'msx.ghe.com/MariusStorhaug'
+Switch-GitHubContext -Context 'msx.ghe.com/MariusStorhaug'
 
 # Set a specific context as the default context using pipeline
-'msx.ghe.com/MariusStorhaug' | Set-GitHubDefaultContext
+'msx.ghe.com/MariusStorhaug' | Switch-GitHubContext
 
-Get-GitHubContext -Context 'github.com/MariusStorhaug' | Set-GitHubDefaultContext
+Get-GitHubContext -Context 'github.com/MariusStorhaug' | Switch-GitHubContext
 
 # Abstraction layers on GitHubContexts
 Get-GitHubContext -Context 'msx.ghe.com/MariusStorhaug'
-Get-Context -ID 'PSModule.GitHub/msx.ghe.com/MariusStorhaug'
 
 ###
 ### DISCONNECTING

src/classes/public/Config/GitHubConfig.ps1

@@ -3,7 +3,7 @@
     [string] $ID
 
     # The access token grace period in hours.
-    [int] $AccessTokenGracePeriodInHours
+    [System.Nullable[int]] $AccessTokenGracePeriodInHours
 
     # The default context.
     [string] $DefaultContext
@@ -27,16 +27,16 @@
     [string] $HttpVersion
 
     # The default value for the 'per_page' API parameter used in 'GET' functions that support paging.
-    [int] $PerPage
+    [System.Nullable[int]] $PerPage
 
     # The default value for retry count.
-    [int] $RetryCount
+    [System.Nullable[int]] $RetryCount
 
     # The default value for retry interval in seconds.
-    [int] $RetryInterval
+    [System.Nullable[int]] $RetryInterval
 
     # The tolerance time in seconds for JWT token validation.
-    [int] $JwtTimeTolerance
+    [System.Nullable[int]] $JwtTimeTolerance
 
     # Simple parameterless constructor
     GitHubConfig() {}

src/functions/private/Apps/GitHub Apps/Get-GitHubAppInstallableOrganization.ps1

@@ -34,7 +34,6 @@
     begin {
         $stackPath = Get-PSCallStackPath
         Write-Debug "[$stackPath] - Start"
-        $Context = Resolve-GitHubContext -Context $Context
         Assert-GitHubContext -Context $Context -AuthType IAT, UAT
         # enterprise_organization_installations=read
     }

src/functions/private/Auth/Context/Assert-GitHubContext.ps1

@@ -35,33 +35,32 @@
 
     process {
         $command = (Get-PSCallStack)[1].Command
+        Write-Verbose "Context: $Context"
+        Write-Verbose "AuthType: $AuthType"
 
-        if ($Context) {
-            if ($Context.AuthType -in $AuthType) {
-                return
-            }
-            $PSCmdlet.ThrowTerminatingError(
-                [System.Management.Automation.ErrorRecord]::new(
-                    [System.Exception]::new("The context '$($Context.Name)' does not match the required AuthTypes [$AuthType] for [$command]."),
-                    "InvalidContextAuthType",
-                    [System.Management.Automation.ErrorCategory]::InvalidArgument,
-                    $Context
-                )
-            )
-        } else {
+        if (-not $Context) {
             if ('Anonymous' -in $AuthType) {
                 return
             }
             $PSCmdlet.ThrowTerminatingError(
                 [System.Management.Automation.ErrorRecord]::new(
                     [System.Exception]::new("Please provide a valid context or log in using 'Connect-GitHub'."),
-                    "InvalidContext",
+                    'InvalidContext',
                     [System.Management.Automation.ErrorCategory]::InvalidArgument,
                     $Context
                 )
             )
         }
-
+        if ($Context -eq 'Anonymous' -and $AuthType -contains 'Anonymous') { return }
+        if ($Context.AuthType -in $AuthType) { return }
+        $PSCmdlet.ThrowTerminatingError(
+            [System.Management.Automation.ErrorRecord]::new(
+                [System.Exception]::new("The context '$($Context.Name)' does not match the required AuthTypes [$AuthType] for [$command]."),
+                'InvalidContextAuthType',
+                [System.Management.Automation.ErrorCategory]::InvalidArgument,
+                $Context
+            )
+        )
         # TODO: Implement permission check
         # if ($Context.AuthType -in 'IAT' -and $Context.Permission -notin $Permission) {
         #     throw "The context '$($Context.Name)' does not match the required Permission [$Permission] for [$command]."

src/functions/private/Auth/Context/Remove-GitHubContext.ps1

@@ -1,6 +1,4 @@
-#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '7.0.2' }
-
-filter Remove-GitHubContext {
+filter Remove-GitHubContext {
     <#
         .SYNOPSIS
         Removes a context from the context vault.
@@ -36,14 +34,13 @@ filter Remove-GitHubContext {
     }
 
     process {
-        $ID = "$($script:GitHub.Config.ID)/$Context"
-
         if ($PSCmdlet.ShouldProcess($context.Name, 'Remove context')) {
-            Remove-Context -ID $ID
+            Remove-Context -ID $Context -Vault $script:GitHub.ContextVault
         }
     }
 
     end {
         Write-Debug "[$stackPath] - End"
     }
 }
+#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '8.0.2' }

src/functions/private/Auth/Context/Resolve-GitHubContext.ps1

@@ -27,7 +27,11 @@
         # Can be either a string or a GitHubContext object.
         [Parameter(Mandatory, ValueFromPipeline)]
         [AllowNull()]
-        [object] $Context
+        [object] $Context,
+
+        # If specified, makes an anonymous request to the GitHub API without authentication.
+        [Parameter()]
+        [bool] $Anonymous
     )
 
     begin {
@@ -37,10 +41,25 @@
     }
 
     process {
+        Write-Verbose "Context: [$Context]"
+        Write-Verbose "Anonymous: [$Anonymous]"
+        if ($Anonymous -or $Context -eq 'Anonymous') {
+            Write-Verbose 'Returning Anonymous context.'
+            return [GitHubContext]@{
+                Name     = 'Anonymous'
+                AuthType = 'Anonymous'
+            }
+        }
+
         if ($Context -is [string]) {
             $contextName = $Context
-            Write-Debug "Getting context: [$contextName]"
-            $Context = Get-GitHubContext -Context $contextName
+            Write-Verbose "Getting context: [$contextName]"
+            return Get-GitHubContext -Context $contextName
+        }
+
+        if ($null -eq $Context) {
+            Write-Verbose 'Context is null, returning default context.'
+            return Get-GitHubContext
         }
 
         # TODO: Implement App installation context resolution

src/functions/private/Auth/Context/Set-GitHubContext.ps1

@@ -1,6 +1,4 @@
-#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '7.0.2' }
-
-function Set-GitHubContext {
+function Set-GitHubContext {
     <#
         .SYNOPSIS
         Sets the GitHub context and stores it in the context vault.
@@ -143,8 +141,8 @@ function Set-GitHubContext {
             $contextObj | Out-String -Stream | ForEach-Object { Write-Debug $_ }
             Write-Debug '----------------------------------------------------'
             if ($PSCmdlet.ShouldProcess('Context', 'Set')) {
-                Write-Debug "Saving context: [$($script:GitHub.Config.ID)/$($contextObj['Name'])]"
-                Set-Context -ID "$($script:GitHub.Config.ID)/$($contextObj['Name'])" -Context $contextObj
+                Write-Debug "Saving context: [$($contextObj['Name'])]"
+                Set-Context -ID $($contextObj['Name']) -Context $contextObj -Vault $script:GitHub.ContextVault
                 if ($Default) {
                     Switch-GitHubContext -Context $contextObj['Name']
                 }
@@ -170,3 +168,4 @@ function Set-GitHubContext {
         Write-Debug "[$stackPath] - End"
     }
 }
+#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '8.0.2' }

src/functions/private/Auth/DeviceFlow/Update-GitHubUserAccessToken.ps1

@@ -85,7 +85,7 @@
         $Context.RefreshTokenExpirationDate = (Get-Date).AddSeconds($tokenResponse.refresh_token_expires_in)
 
         if ($PSCmdlet.ShouldProcess('Access token', 'Update/refresh')) {
-            Set-Context -Context $Context -ID $Context.ID
+            Set-Context -Context $Context -Vault $script:GitHub.ContextVault
         }
 
         if ($PassThru) {
@@ -98,4 +98,4 @@
         Write-Debug "[$stackPath] - End"
     }
 }
-#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '7.0.2' }
+#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '8.0.2' }

src/functions/private/Config/Initialize-GitHubConfig.ps1

@@ -1,6 +1,4 @@
-#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '7.0.2' }
-
-function Initialize-GitHubConfig {
+function Initialize-GitHubConfig {
     <#
         .SYNOPSIS
         Initialize the GitHub module configuration.
@@ -34,7 +32,7 @@ function Initialize-GitHubConfig {
         Write-Debug "Force:           [$Force]"
         if ($Force) {
             Write-Debug 'Forcing initialization of GitHubConfig.'
-            $context = Set-Context -ID $script:GitHub.DefaultConfig.ID -Context $script:GitHub.DefaultConfig -PassThru
+            $context = Set-Context -Context $script:GitHub.DefaultConfig -Vault $script:GitHub.ContextVault -PassThru
             $script:GitHub.Config = [GitHubConfig]$context
             return
         }
@@ -46,11 +44,11 @@ function Initialize-GitHubConfig {
         }
 
         Write-Debug 'Attempt to load the stored GitHubConfig from ContextVault'
-        $context = Get-Context -ID $script:GitHub.DefaultConfig.ID
+        $context = Get-Context -ID $script:GitHub.DefaultConfig.ID -Vault $script:GitHub.ContextVault
         if ($context) {
             Write-Debug 'GitHubConfig loaded into memory.'
 
-            Write-Debug "Checking if new default properties are available in the stored context."
+            Write-Debug 'Checking if new default properties are available in the stored context.'
             $needsUpdate = $false
             $defaultProperties = $script:GitHub.DefaultConfig.PSObject.Properties.Name
             foreach ($propName in $defaultProperties) {
@@ -62,18 +60,19 @@ function Initialize-GitHubConfig {
             }
             if ($needsUpdate) {
                 Write-Debug 'Updating stored context with new default properties'
-                $context = Set-Context -ID $script:GitHub.DefaultConfig.ID -Context $context -PassThru
+                $context = Set-Context -Context $context -Vault $script:GitHub.ContextVault -PassThru
             }
 
             $script:GitHub.Config = [GitHubConfig]$context
             return
         }
         Write-Debug 'Initializing GitHubConfig from defaults'
-        $context = Set-Context -ID $script:GitHub.DefaultConfig.ID -Context $script:GitHub.DefaultConfig -PassThru
+        $context = Set-Context -Context $script:GitHub.DefaultConfig -Vault $script:GitHub.ContextVault -PassThru
         $script:GitHub.Config = [GitHubConfig]$context
     }
 
     end {
         Write-Debug "[$stackPath] - End"
     }
 }
+#Requires -Modules @{ ModuleName = 'Context'; RequiredVersion = '8.0.2' }

src/functions/private/Gitignore/Get-GitHubGitignoreByName.ps1

@@ -21,10 +21,6 @@
         [Parameter(Mandatory)]
         [string] $Name,
 
-        # If specified, makes an anonymous request to the GitHub API without authentication.
-        [Parameter()]
-        [switch] $Anonymous,
-
         # The context to run the command in. Used to get the details for the API call.
         # Can be either a string or a GitHubContext object.
         [Parameter()]
@@ -42,7 +38,6 @@
             Method      = 'GET'
             APIEndpoint = "/gitignore/templates/$Name"
             Accept      = 'application/vnd.github.raw+json'
-            Anonymous   = $Anonymous
             Context     = $Context
         }
 

src/functions/private/Gitignore/Get-GitHubGitignoreList.ps1

@@ -19,10 +19,6 @@
     [OutputType([string[]])]
     [CmdletBinding()]
     param(
-        # If specified, makes an anonymous request to the GitHub API without authentication.
-        [Parameter()]
-        [switch] $Anonymous,
-
         # The context to run the command in. Used to get the details for the API call.
         # Can be either a string or a GitHubContext object.
         [Parameter()]
@@ -39,7 +35,6 @@
         $inputObject = @{
             Method      = 'GET'
             APIEndpoint = '/gitignore/templates'
-            Anonymous   = $Anonymous
             Context     = $Context
         }
 

src/functions/private/License/Get-GitHubLicenseByName.ps1

@@ -23,10 +23,6 @@
         [Parameter(Mandatory)]
         [string] $Name,
 
-        # If specified, makes an anonymous request to the GitHub API without authentication.
-        [Parameter()]
-        [switch] $Anonymous,
-
         # The context to run the command in. Used to get the details for the API call.
         # Can be either a string or a GitHubContext object.
         [Parameter()]
@@ -44,7 +40,6 @@
             Method      = 'GET'
             APIEndpoint = "/licenses/$Name"
             Accept      = 'application/vnd.github+json'
-            Anonymous   = $Anonymous
             Context     = $Context
         }
 

src/functions/private/License/Get-GitHubLicenseList.ps1

@@ -22,10 +22,6 @@
     [OutputType([GitHubLicense[]])]
     [CmdletBinding()]
     param(
-        # If specified, makes an anonymous request to the GitHub API without authentication.
-        [Parameter()]
-        [switch] $Anonymous,
-
         # The context to run the command in. Used to get the details for the API call.
         # Can be either a string or a GitHubContext object.
         [Parameter()]
@@ -42,7 +38,6 @@
         $inputObject = @{
             Method      = 'GET'
             APIEndpoint = '/licenses'
-            Anonymous   = $Anonymous
             Context     = $Context
         }
 

src/functions/private/License/Get-GitHubRepositoryLicense.ps1

@@ -36,10 +36,6 @@
         [ValidateSet('raw', 'html')]
         [string] $Type = 'raw',
 
-        # If specified, makes an anonymous request to the GitHub API without authentication.
-        [Parameter()]
-        [switch] $Anonymous,
-
         # The context to run the command in. Used to get the details for the API call.
         # Can be either a string or a GitHubContext object.
         [Parameter(Mandatory)]
@@ -62,7 +58,6 @@
             Method      = 'GET'
             APIEndpoint = "/repos/$Owner/$Repository/license"
             ContentType = $contentType
-            Anonymous   = $Anonymous
             Context     = $Context
         }