Nebula.Core

1.2.2

Public/NC.Utils.ps1

#Requires -Version 5.0
using namespace System.Management.Automation

# Nebula.Core: Utilities helpers ====================================================================================================================

function Format-MessageIDsFromClipboard {
    <#
    .SYNOPSIS
        Formats quarantine identities from the clipboard.
    .DESCRIPTION
        Reads quarantine identities (one per line) from the clipboard, deduplicates them, copies the
        formatted list back to the clipboard, and optionally releases the messages immediately.
    .PARAMETER NoRelease
        Skip the automatic release of the identity entries.
    .PARAMETER PassThru
        Emit the formatted, comma-separated string to the pipeline in addition to copying it to
        the clipboard.
    .EXAMPLE
        Format-MessageIDsFromClipboard -PassThru
    #>
    [CmdletBinding(SupportsShouldProcess = $true)]
    param(
        [switch]$NoRelease,
        [switch]$PassThru
    )

    $clipboard = Get-Clipboard
    if ([string]::IsNullOrWhiteSpace($clipboard)) {
        Write-NCMessage "Clipboard is empty. Copy quarantine identities first." -Level WARNING
        return
    }

    $ids = $clipboard -split "`r?`n" | ForEach-Object { $_.Trim().Trim('"').Trim("'") } | Where-Object { $_ }
    if (-not $ids -or $ids.Count -eq 0) {
        Write-NCMessage "No quarantine identities found in clipboard." -Level WARNING
        return
    }

    $normalized = $ids | Select-Object -Unique
    $quoted = $normalized | ForEach-Object { "`"$($_)`"" }
    $output = $quoted -join ", "

    $output | Set-Clipboard
    $identityLabel = if ($normalized.Count -eq 1) { 'quarantine identity value' } else { 'quarantine identity values' }
    Write-NCMessage ("Copied {0} {1} to clipboard:`n{2}" -f $normalized.Count, $identityLabel, ($normalized -join "`n")) -Level INFO
    Add-EmptyLine
    Write-NCMessage "Please wait for messages to be released." -Level INFO

    if (-not $NoRelease.IsPresent -and $PSCmdlet.ShouldProcess("quarantine", "Release messages by Identity")) {
        Unlock-QuarantineMessageId -Identity $normalized
    }

    if ($PassThru.IsPresent) { $output }
}

Set-Alias -Name mids -Value Format-MessageIDsFromClipboard -Description "Format MessageId values from clipboard"

function Format-SortedEmailsFromClipboard {
    <#
    .SYNOPSIS
        Extracts, deduplicates, and sorts e-mail addresses from clipboard text.
    .DESCRIPTION
        Parses e-mail addresses from the clipboard, removes duplicates, sorts them, and copies
        a quoted, comma-separated list back to the clipboard.
    .PARAMETER PassThru
        Emit the formatted string to the pipeline in addition to copying it to the clipboard.
    .EXAMPLE
        Format-SortedEmailsFromClipboard -PassThru
    #>
    [CmdletBinding()]
    param(
        [switch]$PassThru
    )

    $clipboard = Get-Clipboard
    if ([string]::IsNullOrWhiteSpace($clipboard)) {
        Write-NCMessage "Clipboard is empty. Copy text containing e-mail addresses first." -Level WARNING
        return
    }

    $emailPattern = '[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}'
    $emailList = [regex]::Matches($clipboard, $emailPattern) | ForEach-Object { $_.Value }

    if (-not $emailList -or $emailList.Count -eq 0) {
        Write-NCMessage "No e-mail addresses found in clipboard content." -Level WARNING
        return
    }

    $uniqueSortedEmails = $emailList | Sort-Object -Unique
    $quoted = $uniqueSortedEmails | ForEach-Object { "`"$($_)`"" }
    $output = $quoted -join ", "

    $output | Set-Clipboard
    $emailLabel = if ($uniqueSortedEmails.Count -eq 1) { 'unique e-mail address' } else { 'unique e-mail addresses' }
    Write-NCMessage ("Copied {0} {1} to clipboard." -f $uniqueSortedEmails.Count, $emailLabel) -Level INFO

    if ($PassThru.IsPresent) { $output }
}

Set-Alias -Name fse -Value Format-SortedEmailsFromClipboard -Description "Format sorted e-mails from clipboard"

function Format-QuotedListFromClipboard {
    <#
    .SYNOPSIS
        Formats clipboard text as a quoted, comma-separated list.
    .DESCRIPTION
        Reads text from the clipboard, splits it on lines and tabs, trims each value, removes
        duplicates while preserving the first occurrence, and copies the resulting quoted list
        back to the clipboard.
    .PARAMETER PassThru
        Emit the formatted string to the pipeline in addition to copying it to the clipboard.
    .EXAMPLE
        Format-QuotedListFromClipboard -PassThru
    #>
    [CmdletBinding()]
    param(
        [switch]$PassThru
    )

    $clipboard = Get-Clipboard -Raw
    if ([string]::IsNullOrWhiteSpace($clipboard)) {
        Write-NCMessage "Clipboard is empty. Copy a list of values first." -Level WARNING
        return
    }

    $items = $clipboard -split "\r?\n|\t" | ForEach-Object {
        $_.Trim().Trim('"').Trim("'")
    } | Where-Object { $_ }

    if (-not $items -or $items.Count -eq 0) {
        Write-NCMessage "No values found in clipboard content." -Level WARNING
        return
    }

    $seen = [System.Collections.Generic.HashSet[string]]::new([System.StringComparer]::OrdinalIgnoreCase)
    $normalized = [System.Collections.Generic.List[string]]::new()
    foreach ($item in $items) {
        if ($seen.Add($item)) {
            $normalized.Add($item) | Out-Null
        }
    }

    $quoted = $normalized | ForEach-Object { "`"$($_.Replace('"', '""'))`"" }
    $output = $quoted -join ","

    $output | Set-Clipboard
    $label = if ($normalized.Count -eq 1) { 'value' } else { 'values' }
    Write-NCMessage ("Copied {0} formatted {1} to clipboard." -f $normalized.Count, $label) -Level INFO

    if ($PassThru.IsPresent) { $output }
}