Audit event tweaks and sample report

examples/membership_audit.ps1

@@ -0,0 +1,47 @@
+function Get-GitlabMembershipReport {
+    param(
+        [string]
+        [Parameter(Mandatory, Position=0)]
+        $GroupName,
+
+        [string]
+        [Parameter(Mandatory)]
+        $StartDate,
+
+        [string]
+        [Parameter()]
+        $EndDate
+    )
+
+    $Group = Get-GitlabGroup $GroupName
+
+    $CurrentMembership = $Group | Get-GitlabGroupMember
+    $AuditRequest = @{
+        GroupId      = $Group.Id
+        All          = $true
+        FetchAuthors = $true
+        After        = $StartDate
+    }
+    if ($EndDate) {
+        Before = $EndDate
+    }
+
+    Write-Host "Current membership of '$GroupName' on $(Get-Date):"
+    $CurrentMembership | Foreach-Object {
+        [PSCustomObject]@{
+            'User'       = $_.Name
+            'Access'     = $_.AccessLevelFriendly
+            'Granted On' = $_.CreatedAt
+        }
+    } | Format-Markdown
+    Write-Host "`nChanges to membership since $StartDate`:"
+    Get-GitlabAuditEvent @AuditRequest |
+        Where-Object { $_.Details.add -eq 'user_access' -or $_.Details.remove -eq 'user_access' -or $_.Details.change -eq 'access_level' } |
+        ForEach-Object {
+            [PSCustomObject]@{
+                Timestamp = $_.CreatedAt
+                User      = $_.Author.Name
+                Action    = $_.Summary
+            }
+        } | Format-Markdown
+}

src/GitlabCli/AuditEvents.psm1

@@ -45,7 +45,7 @@ function Get-GitlabAuditEvent {
         $After,
 
         [Parameter()]
-        [int]
+        [uint]
         $MaxPages = $global:GitlabGetProjectDefaultPages,
 
         [Parameter()]

src/GitlabCli/GitlabCli.psd1

@@ -1,11 +1,11 @@
 @{
-    ModuleVersion = '1.104.0'
+    ModuleVersion = '1.104.1'
 
     PrivateData = @{
         PSData = @{
             LicenseUri = 'https://github.com/chris-peterson/pwsh-gitlab/blob/main/LICENSE'
             ProjectUri = 'https://github.com/chris-peterson/pwsh-gitlab'
-            ReleaseNotes = 'Upsert protected branches, minor usability improvements'
+            ReleaseNotes = 'Audit event tweaks'
         }
     }
 

src/GitlabCli/Types.ps1xml

@@ -470,7 +470,11 @@
               if ($Details.add) {
                 "Added $($Details.add) ($($Details.target_details)) in $($Details.entity_path)"
               } elseif ($Details.remove) {
-                "Removed $($Details.remove) ($($Details.target_details)) in $($Details.entity_path)"
+                if ($Details.reason) {
+                  "Removed '$($Details.target_details)' ($($Details.reason))"
+                } else {
+                  "Removed $($Details.remove) ($($Details.target_details)) in $($Details.entity_path)"
+                }
               } elseif ($Details.change) {
                 "Changed $($Details.change) ($($Details.target_details)) from $($Details.from) to $($Details.to) in $($Details.entity_path)"
               } elseif ($Details.custom_message) {