🩹 [Patch]: Add Get-GitHubAppInstallation (#131)

## Description

- Add Get-GitHubAppInstallation, to list an applications installations
(with IDs)

## Type of change

<!-- Use the check-boxes [x] on the options that are relevant. -->

- [ ] 📖 [Docs]
- [ ] 🪲 [Fix]
- [x] 🩹 [Patch]
- [ ] ⚠️ [Security fix]
- [ ] 🚀 [Feature]
- [ ] 🌟 [Breaking change]

## Checklist

<!-- Use the check-boxes [x] on the options that are relevant. -->

- [x] I have performed a self-review of my own code
- [x] I have commented my code, particularly in hard-to-understand areas

Author: MariusStorhaug

src/functions/private/Commands/Initialize-RunnerEnvironment.ps1

@@ -12,7 +12,7 @@
         Initializes the runner environment for the GitHub module
     #>
     [CmdletBinding()]
-    param ()
+    param()
 
     Write-Verbose 'Detected running on a GitHub Actions runner, preparing environment...'
     $env:GITHUB_REPOSITORY_NAME = $env:GITHUB_REPOSITORY -replace '.+/'

src/functions/public/Apps/Get-GitHubApp.ps1

@@ -22,7 +22,7 @@
     #>
     [OutputType([pscustomobject])]
     [CmdletBinding()]
-    param ()
+    param()
 
     $inputObject = @{
         APIEndpoint = '/app'

src/functions/public/Apps/Get-GitHubAppInstallation.ps1

@@ -0,0 +1,30 @@
+filter Get-GitHubAppInstallation {
+    <#
+        .SYNOPSIS
+        List installations for the authenticated app
+
+        .DESCRIPTION
+        The permissions the installation has are included under the `permissions` key.
+
+        You must use a [JWT](https://docs.github.com/apps/building-github-apps/authenticating-with-github-apps/#authenticating-as-a-github-app)
+        to access this endpoint.
+
+
+        .EXAMPLE
+        An example
+
+        .NOTES
+        [List installations for the authenticated app](https://docs.github.com/rest/apps/apps#list-installations-for-the-authenticated-app)
+    #>
+    [CmdletBinding()]
+    param()
+
+    $inputObject = @{
+        APIEndpoint = '/app/installations'
+        Method      = 'GET'
+    }
+
+    Invoke-GitHubAPI @inputObject | ForEach-Object {
+        Write-Output $_.Response
+    }
+}

tools/dev/dump.ps1

@@ -85,26 +85,6 @@ query(`$enterpriseSlug: String!, `$first: Int = 100, `$after: String) {
 
 }
 
-function Get-GitHubAppInstallation {
-    [CmdletBinding()]
-    param (
-        [Parameter(Mandatory)]
-        [string] $Token,
-
-        [Parameter()]
-        $BaseURL = $env:GITHUB_API_URL
-    )
-
-    $result = Invoke-RestMethod -Method Get -Uri "$BaseURL/app/installations" -Headers @{
-        'Authorization' = "Bearer $token"
-        'Accept'        = 'application/vnd.github+json'
-    } -FollowRelLink
-
-    $result | ForEach-Object {
-        Write-Output $_
-    }
-}
-
 function Get-GitHubAppInstallationAccessToken {
     [CmdletBinding()]
     param (

tools/utilities/GitHubAPI.ps1

@@ -21,7 +21,7 @@ $response = Invoke-RestMethod -Uri $APIDocURI -Method Get
 # @{n = 'PUT'; e = { (($_.value.psobject.Properties.Name) -contains 'PUT') } }, `
 # @{n = 'PATCH'; e = { (($_.value.psobject.Properties.Name) -contains 'PATCH') } } | Format-Table
 
-$path = '/app'
+$path = '/app/installations'
 $method = 'get'
 $response.paths.$path.$method
 $response.paths.$path.$method.tags | clip                             # -> Namespace/foldername