🚀 [Feature]: Added class GitHubAppInstallationRequest and added ToString() method to the GitHubApp class (#409)

## Description

This pull request introduces several enhancements to the GitHub App
class, including new functionality, renaming for clarity, and updates to
existing tests.

### New class:

* `GitHubAppInstallationRequest`: Added a new class
`GitHubAppInstallationRequest` to represent installation requests for
GitHub Apps. This includes properties for the requester, target account,
and creation date, along with constructors for initialization.
* `Get-GitHubAppInstallationRequest`: Added a new filter
`Get-GitHubAppInstallationRequest` to list pending installation requests
for the authenticated GitHub App.

### Function renaming for clarity:

* `Get-GitHubAppBySlug`: Renamed the private function from
`Get-GitHubAppByName` to `Get-GitHubAppBySlug` to better reflect its
input. Updated parameter names and internal logic accordingly.

### Updates to existing tests:

* `GitHub.Tests.ps1`: Added new test cases for
`Get-GitHubAppInstallationRequest` and restored tests for
`Get-GitHubApp` to validate fetching an app by slug.

### Minor improvements:

* `GitHubApp`: Added a `ToString()` method to return the slug of the
GitHub App.
* `Get-GitHubApp`: Updated output type to `GitHubApp` and improved
parameter handling for pipeline input.

## Type of change

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

- [ ] 📖 [Docs]
- [ ] 🪲 [Fix]
- [ ] 🩹 [Patch]
- [ ] ⚠️ [Security fix]
- [x] 🚀 [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/classes/public/App/GitHubApp.ps1

@@ -63,4 +63,8 @@ class GitHubApp : GitHubNode {
         $this.Events = , ($Object.events)
         $this.Installations = $Object.installations_count
     }
+
+    [string] ToString() {
+        return $this.Slug
+    }
 }

src/classes/public/App/GitHubAppInstallationRequest.ps1

@@ -0,0 +1,21 @@
+class GitHubAppInstallationRequest : GitHubNode {
+    # The user who requested the installation.
+    [GitHubUser] $RequestedBy
+
+    # The target of the installation.
+    [GitHubOwner] $Target
+
+    # The creation date of the installation.
+    # Example: 2008-01-14T04:33:35Z
+    [System.Nullable[datetime]] $CreatedAt
+
+    GitHubAppInstallationRequest() {}
+
+    GitHubAppInstallationRequest([PSCustomObject]$Object) {
+        $this.ID = $Object.id
+        $this.NodeID = $Object.node_id
+        $this.RequestedBy = [GitHubUser]::new($Object.requester)
+        $this.Target = [GitHubOwner]::new($Object.account)
+        $this.CreatedAt = $Object.created_at
+    }
+}

src/functions/private/Apps/GitHub Apps/Get-GitHubAppByName.ps1 renamed to src/functions/private/Apps/GitHub Apps/Get-GitHubAppBySlug.ps1

@@ -1,4 +1,4 @@
-filter Get-GitHubAppByName {
+function Get-GitHubAppBySlug {
     <#
         .SYNOPSIS
         Get an app
@@ -21,8 +21,7 @@
         # You can find this on the settings page for your GitHub App (e.g., https://github.com/settings/apps/<app_slug>).
         # Example: 'github-actions'
         [Parameter(Mandatory)]
-        [Alias('Name')]
-        [string] $AppSlug,
+        [string] $Slug,
 
         # The context to run the command in. Used to get the details for the API call.
         [Parameter(Mandatory)]
@@ -37,9 +36,9 @@
 
     process {
         $inputObject = @{
-            Context     = $Context
-            APIEndpoint = "/apps/$AppSlug"
             Method      = 'GET'
+            APIEndpoint = "/apps/$Slug"
+            Context     = $Context
         }
 
         Invoke-GitHubAPI @inputObject | ForEach-Object {

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

@@ -40,10 +40,10 @@
 
     process {
         $inputObject = @{
-            Context     = $Context
+            Method      = 'GET'
             APIEndpoint = '/app/installations'
             PerPage     = $PerPage
-            Method      = 'GET'
+            Context     = $Context
         }
 
         Invoke-GitHubAPI @inputObject | ForEach-Object {

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

@@ -16,25 +16,29 @@
 
         Get the GitHub App with the slug 'github-actions'.
 
-        .NOTES
-        [Get an app](https://docs.github.com/rest/apps/apps#get-an-app)
-        [Get the authenticated app | GitHub Docs](https://docs.github.com/rest/apps/apps#get-the-authenticated-app)
+        .OUTPUTS
+        GitHubApp
 
         .LINK
         https://psmodule.io/GitHub/Functions/Apps/GitHub%20App/Get-GitHubApp
+
+        .NOTES
+        [Get an app](https://docs.github.com/rest/apps/apps#get-an-app)
+        [Get the authenticated app | GitHub Docs](https://docs.github.com/rest/apps/apps#get-the-authenticated-app)
     #>
-    [OutputType([pscustomobject])]
+    [OutputType([GitHubApp])]
     [CmdletBinding(DefaultParameterSetName = 'Get the authenticated app')]
     param(
         # The AppSlug is just the URL-friendly name of a GitHub App.
         # You can find this on the settings page for your GitHub App (e.g., <https://github.com/settings/apps/{app_slug}>).
         # Example: 'github-actions'
         [Parameter(
             Mandatory,
-            ParameterSetName = 'Get an app by slug'
+            ParameterSetName = 'Get an app by slug',
+            ValueFromPipeline,
+            ValueFromPipelineByPropertyName
         )]
-        [Alias('AppSlug', 'Slug')]
-        [string] $Name,
+        [string] $Slug,
 
         # 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.
@@ -51,7 +55,7 @@
     process {
         switch ($PSCmdlet.ParameterSetName) {
             'Get an app by slug' {
-                Get-GitHubAppByName -AppSlug $Name -Context $Context
+                Get-GitHubAppBySlug -Slug $Slug -Context $Context
             }
             default {
                 Get-GitHubAuthenticatedApp -Context $Context

src/functions/public/Apps/GitHub App/Get-GitHubAppInstallationRequest.ps1

@@ -0,0 +1,56 @@
+filter Get-GitHubAppInstallationRequest {
+    <#
+        .SYNOPSIS
+        List installation requests for the authenticated app.
+
+        .DESCRIPTION
+        Lists all the pending installation requests for the authenticated GitHub App.
+
+        .EXAMPLE
+        Get-GitHubAppInstallationRequest
+
+        Lists all the pending installation requests for the authenticated GitHub App.
+
+        .NOTES
+        [List installation requests for the authenticated app](https://docs.github.com/rest/apps/apps#list-installation-requests-for-the-authenticated-app)
+
+        .LINK
+        https://psmodule.io/GitHub/Functions/Apps/GitHub%20App/Get-GitHubAppInstallationRequest
+    #>
+    [Diagnostics.CodeAnalysis.SuppressMessageAttribute(
+        'PSAvoidLongLines', '', Justification = 'Contains a long link.'
+    )]
+    [OutputType([GitHubAppInstallationRequest])]
+    [CmdletBinding()]
+    param(
+        # 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()]
+        [object] $Context
+    )
+
+    begin {
+        $stackPath = Get-PSCallStackPath
+        Write-Debug "[$stackPath] - Start"
+        $Context = Resolve-GitHubContext -Context $Context
+        Assert-GitHubContext -Context $Context -AuthType APP
+    }
+
+    process {
+        $inputObject = @{
+            Method      = 'GET'
+            APIEndpoint = '/app/installation-requests'
+            Context     = $Context
+        }
+
+        Invoke-GitHubAPI @inputObject | ForEach-Object {
+            $_.Response | ForEach-Object {
+                [GitHubAppInstallationRequest]::new($_)
+            }
+        }
+    }
+
+    end {
+        Write-Debug "[$stackPath] - End"
+    }
+}

tests/GitHub.Tests.ps1

@@ -419,13 +419,6 @@ Describe 'Apps' {
                     $app.Events | Should -BeOfType 'string'
                     $app.Installations | Should -Not -BeNullOrEmpty
                 }
-                # It 'Get-GitHubApp - Get an app by slug' {
-                #     $app = Get-GitHubApp -Name 'github-actions'
-                #     LogGroup 'App by slug' {
-                #         Write-Host ($app | Format-Table | Out-String)
-                #     }
-                #     $app | Should -Not -BeNullOrEmpty
-                # }
 
                 It 'Get-GitHubAppJSONWebToken - Can get a JWT for the app' {
                     $jwt = Get-GitHubAppJSONWebToken @connectParams
@@ -435,6 +428,13 @@ Describe 'Apps' {
                     $jwt | Should -Not -BeNullOrEmpty
                 }
 
+                It 'Get-GitHubAppInstallationRequest - Can get installation requests' {
+                    $installationRequests = Get-GitHubAppInstallationRequest
+                    LogGroup 'Installation requests' {
+                        Write-Host ($installationRequests | Format-List | Out-String)
+                    }
+                }
+
                 It 'Get-GitHubAppInstallation - Can get app installations' {
                     $installations = Get-GitHubAppInstallation
                     LogGroup 'Installations' {
@@ -460,6 +460,7 @@ Describe 'Apps' {
                         $installation.SuspendedBy | Should -BeOfType 'GitHubUser'
                     }
                 }
+
                 It 'New-GitHubAppInstallationAccessToken - Can get app installation access tokens' {
                     $installations = Get-GitHubAppInstallation
                     LogGroup 'Tokens' {
@@ -525,6 +526,13 @@ Describe 'Apps' {
         if ($Type -eq 'GitHub Actions') {}
 
         # Tests for IAT UAT and PAT goes here
+        It 'Get-GitHubApp - Get an app by slug' {
+            $app = Get-GitHubApp -Slug 'github-actions'
+            LogGroup 'App by slug' {
+                Write-Host ($app | Format-List | Out-String)
+            }
+            $app | Should -Not -BeNullOrEmpty
+        }
     }
 }