MatterMostV4

1.0.1

Public/Users/Get-MMUser.ps1

# Получение пользователя MatterMost по ID, username, фильтру или текущей сессии

function Get-MMUser {
    <#
    .SYNOPSIS
        Returns a MatterMost user by ID, username, filter, or current session.
    .EXAMPLE
        Get-MMUser -All
    .EXAMPLE
        Get-MMUser -Me
    .EXAMPLE
        Get-MMUser -Username "testuser"
    .EXAMPLE
        Get-MMUser -UserId "abc123"
    .EXAMPLE
        Get-MMUser -Filter {username -eq 'admin'}
    .EXAMPLE
        Get-MMUser -Filter {username -like 'adm*'}
    .EXAMPLE
        Get-MMUser -Filter {username -ne 'admin'}
    .EXAMPLE
        $user | Get-MMUser
    .EXAMPLE
        Get-MMUser -Ids 'abc123', 'def456'
    .EXAMPLE
        Get-MMUser -Usernames 'john', 'jane'
    #>
    [OutputType('MMUser')]
    [CmdletBinding(DefaultParameterSetName = 'Me')]
    param(
        [Parameter(ParameterSetName = 'All')]
        [switch]$All,

        [Parameter(ParameterSetName = 'Me')]
        [switch]$Me,

        [Parameter(Mandatory, ParameterSetName = 'ById', ValueFromPipelineByPropertyName)]
        [Alias('id')]
        [string]$UserId,

        [Parameter(Mandatory, ParameterSetName = 'ByUsername', Position = 0)]
        [string]$Username,

        [Parameter(Mandatory, ParameterSetName = 'ByEmail')]
        [string]$Email,

        [Parameter(Mandatory, ParameterSetName = 'ByIds')]
        [string[]]$Ids,

        [Parameter(Mandatory, ParameterSetName = 'ByUsernames')]
        [string[]]$Usernames,

        [Parameter(Mandatory, ParameterSetName = 'Filter')]
        [scriptblock]$Filter
    )

    process {
        switch ($PSCmdlet.ParameterSetName) {
            'All'         { Get-MMUserList                                                      | ConvertTo-MMUser }
            'Me'          { Invoke-MMRequest -Endpoint 'users/me'                               | ConvertTo-MMUser }
            'ById'        { Invoke-MMRequest -Endpoint "users/$UserId"                          | ConvertTo-MMUser }
            'ByUsername'  { Invoke-MMRequest -Endpoint "users/username/$Username"               | ConvertTo-MMUser }
            'ByEmail'     { Invoke-MMRequest -Endpoint "users/email/$Email"                     | ConvertTo-MMUser }
            'ByIds'       { Invoke-MMRequest -Endpoint 'users/ids' -Method POST -Body $Ids      | ConvertTo-MMUser }
            'ByUsernames' { Invoke-MMRequest -Endpoint 'users/usernames' -Method POST -Body $Usernames | ConvertTo-MMUser }
            'Filter'      { Invoke-MMUserFilter -Filter $Filter                                 | ConvertTo-MMUser }
        }
    }
}

function Invoke-MMUserFilter {
    <#
    .SYNOPSIS
        Parses a filter ScriptBlock and returns MatterMost users matching the condition.
    #>
    param([scriptblock]$Filter)

    $filterStr = $Filter.ToString().Trim()

    if ($filterStr -notmatch "^(\w+)\s+(-eq|-like|-ne)\s+['""]([^'""]+)['""]$") {
        throw "Invalid filter syntax. Supported: {field -eq 'value'}, {field -like 'value'}, {field -ne 'value'}"
    }

    $field    = $Matches[1]
    $operator = $Matches[2]
    $value    = $Matches[3]

    # Быстрый путь: username -eq через прямой endpoint
    if ($field -eq 'username' -and $operator -eq '-eq') {
        return Invoke-MMRequest -Endpoint "users/username/$value"
    }

    # Для -ne нужны все пользователи
    if ($operator -eq '-ne') {
        $users = Get-MMUserList
        return $users | Where-Object { $_.$field -ne $value }
    }

    # Для -eq и -like используем search + клиентская фильтрация
    $searchResults = Invoke-MMRequest -Endpoint 'users/search' -Method POST -Body @{ term = $value; limit = 100 }

    switch ($operator) {
        '-eq'   { $searchResults | Where-Object { $_.$field -eq $value } }
        '-like' { $searchResults | Where-Object { $_.$field -like $value } }
    }
}