[Feature Request]: Add `chat.bsky.group` namespace and group join-link embed

未关闭
#321 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
52/100
Issue 类型
功能
描述清晰度
描述清楚
活跃度
冷清
技术栈
swift
领域
api

调研方向

Start by reading the existing chat lexicon models under Sources/ATProtoKit/Models/Lexicons/chat.bsky/ and API methods under Sources/ATProtoKit/APIReference/ChatBskyAPI/ to follow their conventions. Then compare the listed missing lexicons with the upstream lexicon references and add the typed group wrappers and join-link embed. Done when the listed group operations and embed are represented in the typed pipeline with api.bsky.chat routing.

由索引模型根据 Issue 内容生成。

描述

new feature
Summary

The upstream lexicon now ships a full chat.bsky.group.* namespace (group lifecycle, membership, join links, join requests) plus a chat.bsky.embed.joinLink embed object. None of these are reflected in ATProtoKit, so group conversation management is unreachable through the typed pipeline.

Pain points

The entire group surface (lifecycle, membership, join links, join requests, and the messageInput.embed join-link) has to be hand-built on raw XRPC, re-implementing the api.bsky.chat routing and auth plumbing that ATProtoBlueskyChat already handles for every other chat call.

Considered Alternatives

Raw XRPC for the entire group surface — loses typed pipeline, isRelatedToBskyChat host routing, and forces every consumer to repeat the same auth plumbing.

Is this a breaking change?

No

Library Examples

N/A

Additional Context
Missing lexicons
Lexicon Suggested wrapper
chat.bsky.embed.joinLink ChatBskyLexicon.Embed.JoinLink embed object, selectable in the sendMessage messageInput.embed union
chat.bsky.group.addMembers addMembers(to:memberDIDs:)
chat.bsky.group.approveJoinRequest approveJoinRequest(for:requesterDID:)
chat.bsky.group.createGroup createGroup(name:memberDIDs:memberLimit:)
chat.bsky.group.createJoinLink createJoinLink(for:)
chat.bsky.group.defs types only
chat.bsky.group.disableJoinLink disableJoinLink(for:)
chat.bsky.group.editGroup editGroup(by:name:)
chat.bsky.group.editJoinLink editJoinLink(for:expiresAt:)
chat.bsky.group.enableJoinLink enableJoinLink(for:)
chat.bsky.group.getJoinLinkPreviews getJoinLinkPreviews(for:)
chat.bsky.group.listJoinRequests listJoinRequests(for:limit:cursor:)
chat.bsky.group.listMutualGroups listMutualGroups(with:limit:cursor:)
chat.bsky.group.rejectJoinRequest rejectJoinRequest(for:requesterDID:)
chat.bsky.group.removeMembers removeMembers(from:memberDIDs:)
chat.bsky.group.requestJoin requestJoin(by:)
chat.bsky.group.updateJoinRequestsRead updateJoinRequestsRead(for:)
chat.bsky.group.withdrawJoinRequest withdrawJoinRequest(by:)

Wrappers follow the existing ATProtoBlueskyChat convention (method name mirrors the lexicon's final segment, no artificial Group prefix — matching getConversation, listConversations). All sit on api.bsky.chat and require isRelatedToBskyChat: true routing, and the group namespace maps to ChatBskyLexicon.Group.

Cross-reference
  • The convo-side discriminator (convoView.kind → #groupConvo) and the 4 convo-level endpoints (getConvoMembers, listConvoRequests, lockConvo, unlockConvo) are tracked in a separate feature request #320.
References
主要语言
Swift
星标
226
派生
40
平均合并
5 小时 8 分钟
30 天内合并 PR
3

环境准备

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

MasterJ93/ATProtoKit 的其他 Issue

查看 MasterJ93/ATProtoKit 的全部 Issue

相似的 Issue

更多 Swift Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。