[Feature] Meta - Add the Meta functions

src/GitHub/GitHub.ps1

@@ -1,14 +1,12 @@
-Write-Verbose "Initializing GitHub module..." -Verbose
+$scriptFilePath = $MyInvocation.MyCommand.Path
+
+Write-Verbose "[$scriptFilePath] - Initializing GitHub module..." -Verbose
 
-$script:Config = $script:ConfigTemplate | ConvertTo-Json -Depth 100 | ConvertFrom-Json
 Initialize-SecretVault -Name $script:SecretVault.Name -Type $script:SecretVault.Type
-Restore-GitHubConfig
 
-if (-not [string]::IsNullOrEmpty($env:GH_TOKEN)) {
-    Write-Verbose 'Logging on using GH_TOKEN'
-    Connect-GitHubAccount -AccessToken $env:GH_TOKEN
-}
-if (-not [string]::IsNullOrEmpty($env:GITHUB_TOKEN)) {
-    Write-Verbose 'Logging on using GITHUB_TOKEN'
-    Connect-GitHubAccount -AccessToken $env:GITHUB_TOKEN
+# Autologon if a token is present in environment variables
+$envVar = Get-ChildItem -Path 'Env:' | Where-Object Name -In 'GH_TOKEN', 'GITHUB_TOKEN' | Select-Object -First 1
+$envVarPresent = $envVar.count -gt 0
+if ($envVarPresent) {
+    Connect-GitHubAccount
 }

src/GitHub/GitHub.psm1

@@ -6,28 +6,27 @@ Write-Verbose "[$scriptName] - Importing module"
 
 #region - Importing data files
 Write-Verbose "[$scriptName] - [data] - Processing folder"
-$dataFolder = (Join-Path $PSScriptRoot 'data')
-Write-Verbose "[$scriptName] - [data] - [$dataFolder]"
-Get-ChildItem -Path "$dataFolder" -Recurse -Force -Include '*.psd1' | ForEach-Object {
+$dataFolder = Join-Path $PSScriptRoot 'data'
+Get-ChildItem -Path $dataFolder -Recurse -Force -Include '*.psd1' -ErrorAction SilentlyContinue | ForEach-Object {
     Write-Verbose "[$scriptName] - [data] - [$($_.Name)] - Importing data file"
     New-Variable -Name $_.BaseName -Value (Import-PowerShellDataFile -Path $_.FullName) -Force
     Write-Verbose "[$scriptName] - [data] - [$($_.Name)] - Done"
 }
 Write-Verbose "[$scriptName] - [data] - Done"
-#endregion - Importing datas
+#endregion - Importing data files
 
 #region - Importing script files
 $folders = 'init', 'classes', 'private', 'public'
 foreach ($folder in $folders) {
     Write-Verbose "[$scriptName] - [$folder] - Processing folder"
-    $folderPath = Join-Path -Path $PSScriptRoot -ChildPath $folder
+    $folderPath = Join-Path $PSScriptRoot $folder
     if (Test-Path -Path $folderPath) {
-        $files = Get-ChildItem -Path $folderPath -Include '*.ps1', '*.psm1' -Recurse | Sort-Object -Property FullName
-        foreach ($file in $files) {
-            Write-Verbose "[$scriptName] - [$folder] - [$($file.Name)] - Importing script file"
-            Import-Module $file -Verbose:$false
-            Write-Verbose "[$scriptName] - [$folder] - [$($file.Name)] - Done"
-        }
+        Get-ChildItem -Path $folderPath -Include '*.ps1', '*.psm1' -Recurse |
+            Sort-Object -Property FullName | ForEach-Object {
+                Write-Verbose "[$scriptName] - [$folder] - [$($_.Name)] - Importing script file"
+                Import-Module $_ -Verbose:$false
+                Write-Verbose "[$scriptName] - [$folder] - [$($_.Name)] - Done"
+            }
     }
     Write-Verbose "[$scriptName] - [$folder] - Done"
 }
@@ -44,7 +43,7 @@ Write-Verbose "[$scriptName] - [Root] - Done"
 #endregion - Importing root script files
 
 #region Export module members
-$foldersToProcess = Get-ChildItem -Path $PSScriptRoot -Directory | Where-Object -Property Name -In $folders
+$foldersToProcess = Get-ChildItem -Path $PSScriptRoot -Directory | Where-Object Name -In $folders
 $moduleFiles = $foldersToProcess | Get-ChildItem -Include '*.ps1' -Recurse -File -Force
 $functions = $moduleFiles.BaseName
 $param = @{
@@ -54,9 +53,9 @@ $param = @{
     Alias    = '*'
 }
 
-Write-Verbose 'Exporting module members'
-
+Write-Verbose "[$scriptName] - Exporting module members"
 Export-ModuleMember @param
+Write-Verbose "[$scriptName] - Exporting module members - Done"
 #endregion Export module members
 
 Write-Verbose "[$scriptName] - Done"

src/GitHub/data/SecretVault.psd1

@@ -1,7 +1,5 @@
 @{
-    Name   = 'GitHub'                           # $script:SecretVault.Name
+    Name   = 'SecretStore'                      # $script:SecretVault.Name
     Type   = 'Microsoft.PowerShell.SecretStore' # $script:SecretVault.Type
-    Secret = @{
-        Name = 'Config'                           # $script:SecretVault.Secret.Name
-    }
+    Prefix = 'GHPS_'                            # $script:SecretVault.Prefix
 }

src/GitHub/en_US/about_Config.help.txt

@@ -53,8 +53,6 @@ FUNCTIONS
 
     - Get-GitHubConfig: Fetches the current module configuration.
     - Reset-GitHubConfig: Resets all or specific sections to its default values.
-    - Restore-GitHubConfig: Restores the configuration from the secret vault.
-    - Save-GitHubConfig: Saves the current configuration to the secret vault.
     - Set-GitHubConfig: Allows setting specific elements of the configuration.
 
 CONFIGURATION
@@ -87,21 +85,10 @@ EXAMPLES
 
     -------------------------- EXAMPLE 3 --------------------------
 
-    Restore-GitHubConfig
+    Reset-GitHubConfig -Scope Auth
 
-    This command restores the GitHub configuration from the secret vault.
+    This command resets the Auth related settings of the GitHub configuration to its default values.
 
-    -------------------------- EXAMPLE 4 --------------------------
-
-    Reset-GitHubConfig -Scope 'App.API'
-
-    This command resets the 'App.API' section of the GitHub configuration to its default values.
-
-    -------------------------- EXAMPLE 5 --------------------------
-
-    Save-GitHubConfig
-
-    This command saves the current GitHub configuration to the secret vault.
 
 KEYWORDS
 

src/GitHub/private/Auth/DeviceFlow/Invoke-GitHubDeviceFlowLogin.ps1

@@ -33,7 +33,7 @@
 
         # The refresh token to use for re-authentication.
         [Parameter()]
-        [string] $RefreshToken
+        [securestring] $RefreshToken
     )
 
     do {

src/GitHub/private/Auth/DeviceFlow/Request-GitHubAccessToken.ps1

@@ -35,7 +35,7 @@
             Mandatory,
             ParameterSetName = 'RefreshToken'
         )]
-        [string] $RefreshToken
+        [securestring] $RefreshToken
     )
 
     $body = @{
@@ -44,7 +44,7 @@
 
     if ($PSBoundParameters.ContainsKey('RefreshToken')) {
         $body += @{
-            'refresh_token' = $RefreshToken
+            'refresh_token' = (ConvertFrom-SecureString $RefreshToken -AsPlainText)
             'grant_type'    = 'refresh_token'
         }
     }
@@ -67,6 +67,8 @@
         Write-Verbose ($RESTParams.GetEnumerator() | Out-String)
 
         $tokenResponse = Invoke-RestMethod @RESTParams -Verbose:$false
+
+        Write-Verbose ($tokenResponse | ConvertTo-Json | Out-String)
         return $tokenResponse
     } catch {
         Write-Error $_

src/GitHub/private/Auth/DeviceFlow/Request-GitHubDeviceCode.ps1

@@ -56,4 +56,3 @@
         throw $_
     }
 }
-

src/GitHub/private/Auth/DeviceFlow/Wait-GitHubAccessToken.ps1

@@ -38,7 +38,7 @@
             Mandatory,
             ParameterSetName = 'RefreshToken'
         )]
-        [string] $RefreshToken,
+        [securestring] $RefreshToken,
 
         # The interval to wait between polling for the token.
         [Parameter()]

src/GitHub/private/Config/Initialize-SecretVault.ps1

@@ -16,26 +16,27 @@ function Initialize-SecretVault {
     Initializes a secret vault named 'SecretStore' using the 'Microsoft.PowerShell.SecretStore' module.
 
     .NOTES
-    For more information aobut secret vaults, see https://learn.microsoft.com/en-us/powershell/utility-modules/secretmanagement/overview?view=ps-modules
+    For more information about secret vaults, see https://learn.microsoft.com/en-us/powershell/utility-modules/secretmanagement/overview?view=ps-modules
     #>
+
     [OutputType([void])]
     [CmdletBinding()]
     param (
         # The name of the secret vault.
         [Parameter()]
-        [string] $Name,
+        [string] $Name = 'SecretStore',
 
         # The type of the secret vault.
         [Parameter()]
         [Alias('ModuleName')]
-        [string] $Type
+        [string] $Type = 'Microsoft.PowerShell.SecretStore'
     )
 
-    $secretVault = Get-SecretVault | Where-Object { $_.ModuleName -eq $Type }
-    $secretVaultExists = $secretVault.count -ne 0
-    Write-Verbose "[$Name] - exists - [$secretVaultExists]"
-    if (-not $secretVaultExists) {
-        Write-Verbose "[$Name] - Registering"
+    $functionName = $MyInvocation.MyCommand.Name
+
+    $vault = Get-SecretVault | Where-Object { $_.ModuleName -eq $Type }
+    if (-not $vault) {
+        Write-Verbose "[$functionName] - [$Type] - Registering"
 
         switch ($Type) {
             'Microsoft.PowerShell.SecretStore' {
@@ -51,17 +52,23 @@ function Initialize-SecretVault {
                 Reset-SecretStore @vaultParameters
             }
         }
+        Write-Verbose "[$functionName] - [$Type] - Done"
+    } else {
+        Write-Verbose "[$functionName] - [$Type] - already registered"
     }
 
     $secretStore = Get-SecretVault | Where-Object { $_.Name -eq $Name }
-    $secretStoreExists = $secretStore.count -ne 0
-    if (-not $secretStoreExists) {
+    if (-not $secretStore) {
+        Write-Verbose "[$functionName] - [$Name] - Registering"
         $secretVault = @{
             Name         = $Name
             ModuleName   = $Type
             DefaultVault = $true
             Description  = 'SecretStore'
         }
         Register-SecretVault @secretVault
+        Write-Verbose "[$functionName] - [$Name] - Done"
+    } else {
+        Write-Verbose "[$functionName] - [$Name] - already registered"
     }
 }

src/GitHub/private/Config/Reset-GitHubConfig.ps1

@@ -0,0 +1,62 @@
+function Reset-GitHubConfig {
+    <#
+        .SYNOPSIS
+        Reset the GitHub configuration.
+
+        .DESCRIPTION
+        Reset the GitHub configuration. Specific scopes can be reset by using the Scope parameter.
+
+        .EXAMPLE
+        Reset-GitHubConfig
+
+        Resets the entire GitHub configuration.
+
+        .EXAMPLE
+        Reset-GitHubConfig -Scope 'Auth'
+
+        Resets the Auth related variables of the GitHub configuration.
+    #>
+    [Alias('Reset-GHConfig')]
+    [OutputType([void])]
+    [CmdletBinding()]
+    param(
+        # Reset the GitHub configuration for a specific scope.
+        [Parameter()]
+        [ValidateSet('Auth', 'All')]
+        [string] $Scope = 'All'
+    )
+
+    Write-Verbose "Resetting GitHub configuration for scope '$Scope'..."
+    switch ($Scope) {
+        'Auth' {
+            $Settings = @{
+                AccessToken                = [securestring]::new()
+                AccessTokenExpirationDate  = [datetime]::MinValue
+                AccessTokenType            = ''
+                AuthType                   = ''
+                DeviceFlowType             = ''
+                RefreshToken               = [securestring]::new()
+                RefreshTokenExpirationDate = [datetime]::MinValue
+                Scope                      = ''
+            }
+        }
+        'All' {
+            $Settings = @{
+                AccessToken                = [securestring]::new()
+                AccessTokenExpirationDate  = [datetime]::MinValue
+                AccessTokenType            = ''
+                ApiBaseUri                 = 'https://api.github.com'
+                ApiVersion                 = '2022-11-28'
+                AuthType                   = ''
+                DeviceFlowType             = ''
+                Owner                      = ''
+                RefreshToken               = [securestring]::new()
+                RefreshTokenExpirationDate = [datetime]::MinValue
+                Repo                       = ''
+                Scope                      = ''
+                UserName                   = ''
+            }
+        }
+    }
+    Set-GitHubConfig @Settings
+}