🚀 [Feature]: Get-GitHubRepository now returns custom properties inline (#555)

`Get-GitHubRepository` now includes custom properties directly on the
returned object — no separate API call needed. GraphQL queries that
encounter unavailable fields now return partial results with warnings
instead of failing, and commands that target non-existent resources
return nothing instead of throwing errors. Various spelling corrections
across source files, documentation, and tests are also included.

- Fixes #554
- Fixes #557
- Fixes #558
- Fixes #559

## New: Custom properties on `Get-GitHubRepository` results

`Get-GitHubRepository` now returns custom properties inline when
retrieving a repository by name. Previously, retrieving custom
properties required a separate call to
`Get-GitHubRepositoryCustomProperty`.

```powershell
$repo = Get-GitHubRepository -Owner 'PSModule' -Name 'GitHub'
$repo.CustomProperties | Format-Table

# Name   Value
# ----   -----
# Type   Module
# Status Active
```

A new strongly-typed `GitHubCustomProperty` class provides `Name` and
`Value` properties with consistent casing regardless of whether the data
comes from the REST or GraphQL API.

> **Note**: Custom properties are populated when using
`Get-GitHubRepository` to fetch a specific repository. Other commands
that return repository objects (e.g., listing repositories) may not
include custom properties depending on the underlying API response.

`Get-GitHubRepositoryCustomProperty` remains available if you only need
custom properties without the full repository object.

## Fixed: Queries no longer fail when some fields are unavailable

GraphQL queries that encounter fields unavailable for some repositories
(such as custom properties on repos where permissions are limited) now
return the available data and emit warnings for the errors. Previously,
any GraphQL error — even with valid data — caused a terminating error.

## Fixed: Commands no longer throw when a resource doesn't exist

Commands that query a specific repository, enterprise, or release by
name now return nothing instead of throwing an error when the resource
doesn't exist. This makes it safe to use these commands in conditional
logic without wrapping them in try/catch.

## Technical Details

- New `GitHubCustomProperty` class in
`src/classes/public/Repositories/GitHubCustomProperty.ps1` with
constructors accepting both REST (`property_name`) and GraphQL
(`propertyName`) field names.
- `GitHubRepository` class: `CustomProperties` property changed from
`[PSCustomObject]` to `[GitHubCustomProperty[]]`. `PropertyToGraphQLMap`
entry now maps to `repositoryCustomPropertyValues(first: 100) { nodes {
propertyName value } }`.
- `CustomProperties` removed from the GraphQL field exclusion list in
`Get-GitHubRepositoryByName` and `Get-GitHubMyRepositoryByName` only —
these are the private functions behind `Get-GitHubRepository`.
- `Invoke-GitHubGraphQLQuery`: Error handling split into partial-success
(data + errors → warnings) and full-failure (errors only → terminating
error) branches.
- Null guards added to `Get-GitHubRepositoryByName`,
`Get-GitHubMyRepositoryByName`, `Get-GitHubEnterpriseByName`,
`Get-GitHubReleaseAssetByTag`, and `Get-GitHubReleaseAssetFromLatest`.
- Spelling corrections across 18 files in `.github/`, `examples/`,
`src/classes/`, `src/functions/`, and `tests/`.

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: MariusStorhaug <17722253+MariusStorhaug@users.noreply.github.com>
Co-authored-by: Marius Storhaug <marstor@hotmail.com>

Author: Copilot

.github/copilot-instructions.md

@@ -1,7 +1,7 @@
 # Coding Standards for `GitHub`
 
 Start by reading the general coding standards for [`PSModule`](https://psmodule.io/docs) which is the basis for all modules in the framework.
-Additions or adjustments to those defaults are covered in this document to ensure that the modules drive consistancy for all developers.
+Additions or adjustments to those defaults are covered in this document to ensure that the modules drive consistency for all developers.
 
 ## General Coding Standards
 
@@ -173,7 +173,7 @@ All function documentation follows standard PowerShell help conventions, with so
    - Remove any properties that are purely “API wrapper” fields (e.g., raw HTTP artifacts that aren’t relevant to the user).
    - Cl
 
-- Classes should have ID as the main resource ID, this is the databaseID. The node_id is spesifically in the NodeID property.
+- Classes should have ID as the main resource ID, this is the databaseID. The node_id is specifically in the NodeID property.
 - Classes that use nodeid and databaseid should extend the class called GitHubNode.
 - Objects that belong inside another scope, has the parts of the scope in properties of the class, i.e. Enterprise, Owner/Organization/Account,
   Repository, Environment, etc.

examples/Connecting.ps1

@@ -7,18 +7,18 @@ Connect-GitHub
 
 # Log on to a specific instance of GitHub (enterprise)
 Connect-GitHub -Host 'msx.ghe.com'
-Get-GitHubRepository -Context 'msx.ghe.com/MariusStorhaug' # Contexts are selectable/overrideable on any call
+Get-GitHubRepository -Context 'msx.ghe.com/MariusStorhaug' # Contexts are selectable/overridable on any call
 
 # Connect to GitHub interactively using OAuth App and Device Flow.
 Connect-GitHub -Mode 'OAuthApp' -Scope 'gist read:org repo workflow'
 
 # Connect to GitHub interactively using less desired PAT flow, supports both fine-grained and classic PATs
 Connect-GitHub -UseAccessToken
 
-# Connect to GitHub programatically (GitHub App Installation Access Token or PAT)
+# Connect to GitHub programmatically (GitHub App Installation Access Token or PAT)
 Connect-GitHub -Token ***********
 
-# Connect to GitHub programatically (GitHub Actions)
+# Connect to GitHub programmatically (GitHub Actions)
 Connect-GitHub # Looks for the GITHUB_TOKEN variable
 
 # Connect using a GitHub App and its private key (local signing of JWT)

src/classes/public/Releases/GitHubRelease.ps1

@@ -17,7 +17,7 @@
     # Example: "## What's Changed\n### Other Changes\n* Fix: Enhance repository deletion feedback and fix typo..."
     [string] $Notes
 
-    # Specifies the commitish value that determines where the Git tag is created from
+    # Specifies the committish value that determines where the Git tag is created from
     # Example: "main"
     [string] $Target
 

src/classes/public/Repositories/GitHubCustomProperty.ps1

@@ -0,0 +1,18 @@
+class GitHubCustomProperty {
+    # The name of the custom property.
+    [string] $Name
+
+    # The value of the custom property.
+    [string] $Value
+
+    GitHubCustomProperty() {}
+
+    GitHubCustomProperty([PSCustomObject] $Object) {
+        $this.Name = $Object.property_name ?? $Object.propertyName ?? $Object.Name
+        $this.Value = $Object.value ?? $Object.Value
+    }
+
+    [string] ToString() {
+        return $this.Name
+    }
+}

src/classes/public/Repositories/GitHubRepository.ps1

@@ -182,7 +182,7 @@
     [GithubRepository] $ForkRepository
 
     # Custom properties for the repository.
-    [PSCustomObject] $CustomProperties
+    [GitHubCustomProperty[]] $CustomProperties
 
     # The clone URL of the repository.
     # Example: git://github.com/octocat/Hello-World.git
@@ -242,7 +242,7 @@
         MergeCommitMessage       = 'mergeCommitMessage'
         TemplateRepository       = 'templateRepository { id databaseId name owner { login } }'
         ForkRepository           = 'parent { id databaseId name owner { login }  }'
-        CustomProperties         = ''
+        CustomProperties         = 'repositoryCustomPropertyValues(first: 100) { nodes { propertyName value } }'
         CloneUrl                 = 'url'
         SshUrl                   = 'sshUrl'
         GitUrl                   = 'url'
@@ -298,7 +298,9 @@
             $this.SquashMergeCommitTitle = $Object.squash_merge_commit_title
             $this.MergeCommitMessage = $Object.merge_commit_message
             $this.MergeCommitTitle = $Object.merge_commit_title
-            $this.CustomProperties = $Object.custom_properties
+            $this.CustomProperties = $Object.custom_properties | ForEach-Object {
+                [GitHubCustomProperty]::new($_)
+            }
             $this.TemplateRepository = $null -ne $Object.template_repository ? [GitHubRepository]::New($Object.template_repository) : $null
             $this.ForkRepository = $null -ne $Object.parent ? [GitHubRepository]::New($Object.parent) : $null
             $this.CloneUrl = $Object.clone_url
@@ -353,6 +355,11 @@
             $this.SquashMergeCommitMessage = $Object.squashMergeCommitMessage
             $this.MergeCommitTitle = $Object.mergeCommitTitle
             $this.MergeCommitMessage = $Object.mergeCommitMessage
+            if ($null -ne $Object.repositoryCustomPropertyValues -and $null -ne $Object.repositoryCustomPropertyValues.nodes) {
+                $this.CustomProperties = $Object.repositoryCustomPropertyValues.nodes | ForEach-Object {
+                    [GitHubCustomProperty]::new($_)
+                }
+            }
             $this.TemplateRepository = $null -ne $Object.templateRepository ? [GitHubRepository]::New($Object.templateRepository) : $null
             $this.ForkRepository = $null -ne $Object.parent ? [GitHubRepository]::New($Object.parent) : $null
             $this.CloneUrl = -not [string]::IsNullOrEmpty($Object.url) ? $Object.url + '.git' : $null

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

@@ -31,7 +31,7 @@
     )]
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute(
         'PSAvoidUsingConvertToSecureStringWithPlainText', '',
-        Justification = 'The tokens are recieved as clear text. Mitigating exposure by removing variables and performing garbage collection.'
+        Justification = 'The tokens are received as clear text. Mitigating exposure by removing variables and performing garbage collection.'
     )]
     [Diagnostics.CodeAnalysis.SuppressMessageAttribute(
         'PSAvoidLongLines', '',

src/functions/private/Enterprise/Get-GitHubEnterpriseByName.ps1

@@ -67,7 +67,9 @@ query(`$Slug: String!) {
             Context   = $Context
         }
         $enterpriseResult = Invoke-GitHubGraphQLQuery @enterpriseQuery
-        [GitHubEnterprise]::new($enterpriseResult.enterprise)
+        if ($enterpriseResult.enterprise) {
+            [GitHubEnterprise]::new($enterpriseResult.enterprise)
+        }
     }
 
     end {

src/functions/private/Releases/Assets/Get-GitHubReleaseAssetByTag.ps1

@@ -115,12 +115,14 @@ query(`$owner: String!, `$repository: String!, `$tag: String!, `$perPage: Int, `
 
             Invoke-GitHubGraphQLQuery @apiParams | ForEach-Object {
                 $release = $_.repository.release
-                $assets = $release.releaseAssets
-                foreach ($asset in $assets.nodes) {
-                    [GitHubReleaseAsset]::new($asset)
+                if ($release) {
+                    $assets = $release.releaseAssets
+                    foreach ($asset in $assets.nodes) {
+                        [GitHubReleaseAsset]::new($asset)
+                    }
+                    $hasNextPage = $assets.pageInfo.hasNextPage
+                    $after = $assets.pageInfo.endCursor
                 }
-                $hasNextPage = $assets.pageInfo.hasNextPage
-                $after = $assets.pageInfo.endCursor
             }
         } while ($hasNextPage)
     }

src/functions/private/Releases/Assets/Get-GitHubReleaseAssetFromLatest.ps1

@@ -114,12 +114,14 @@ query(`$owner: String!, `$repository: String!, `$perPage: Int, `$after: String)
 
             Invoke-GitHubGraphQLQuery @apiParams | ForEach-Object {
                 $release = $_.repository.latestRelease
-                $assets = $release.releaseAssets
-                foreach ($asset in $assets.nodes) {
-                    [GitHubReleaseAsset]::new($asset)
+                if ($release) {
+                    $assets = $release.releaseAssets
+                    foreach ($asset in $assets.nodes) {
+                        [GitHubReleaseAsset]::new($asset)
+                    }
+                    $hasNextPage = $assets.pageInfo.hasNextPage
+                    $after = $assets.pageInfo.endCursor
                 }
-                $hasNextPage = $assets.pageInfo.hasNextPage
-                $after = $assets.pageInfo.endCursor
             }
         } while ($hasNextPage)
     }

src/functions/private/Repositories/Get-GitHubMyRepositoryByName.ps1

@@ -78,7 +78,6 @@
             'MergeCommitMessage',
             'TemplateRepository',
             'ForkRepository',
-            'CustomProperties',
             'CloneUrl',
             'SshUrl',
             'GitUrl'
@@ -128,7 +127,10 @@ $graphQLFields
         }
 
         Invoke-GitHubGraphQLQuery @apiParams | ForEach-Object {
-            [GitHubRepository]::new($_.viewer.repository)
+            $repository = $_.viewer.repository
+            if ($repository) {
+                [GitHubRepository]::new($repository)
+            }
         }
     }