Add additional sorting filter keys for member list query

[laevandus]

🔗 Issue Links

Resolves: IOS-605

🎯 Goal

No way for filtering by channel_role and sorting by channel_role in member list queries.

📝 Summary

• Add member list filtering keys: FilterKey.channelRole and FilterKey.email
• Add member list sorting key: ChannelMemberListSortingKey.channelRole
• Encode MemberRole.member as channel_member and MemberRole.moderator as channel_moderator

🛠 Implementation

🧪 Manual Testing Notes

Example snippet for testing filtering and sorting (chewbacca)

let query = ChannelMemberListQuery(
    cid: ChannelId(type: .messaging, id: "83100323-A"),
    filter: .equal(.channelRole, to: .member),
    sort: [.init(key: .channelRole)]
)
let memberList = self.makeMemberList(with: query)
do {
    try await memberList.get()
    let members = await memberList.state.members
    print(members.count)
    for member in members {
        print(member.id, member.memberRole.rawValue)
    }
} catch {
    print(error)
}

☑️ Contributor Checklist

• I have signed the Stream CLA (required)
• This change should be manually QAed
• Changelog is updated with client-facing changes
• Changelog is updated with new localization keys
• New code is covered by unit tests
• Comparison screenshots added for visual changes
• Affected documentation updated (docusaurus, tutorial, CMS)

🎁 Meme

Provide a funny gif or image that relates to your work on this pull request. (Optional)

[Stream-SDK-Bot]

SDK Performance

target	metric	benchmark	branch	performance	status
MessageList	Hitches total duration	10 ms	3.34 ms	66.6% 🔼	🟢
	Duration	2.6 s	2.54 s	2.31% 🔼	🟢
	Hitch time ratio	4 ms per s	1.32 ms per s	67.0% 🔼	🟢
	Frame rate	75 fps	78.26 fps	4.35% 🔼	🟢
	Number of hitches	1	0.4	60.0% 🔼	🟢

[Stream-SDK-Bot]

SDK Size

title	develop	branch	diff	status
StreamChat	7.03 MB	7.03 MB	+1 KB	🟢
StreamChatUI	4.77 MB	4.77 MB	0 KB	🟢

[laevandus]

MemberRole must be encoded like this when using it as member list filter or as sorting key. Note that MemberRole.member is used for member and channel_member values (same with moderation).

[sonarqubecloud]

Quality Gate passed

Issues
170 New issues
0 Accepted issues

Measures
0 Security Hotspots
83.6% Coverage on New Code
0.1% Duplication on New Code

See analysis details on SonarQube Cloud