feat: sync recent call and channel fixes

internal/domain/groupcall.go

@@ -14,6 +14,27 @@ const (
 	GroupCallStateDiscarded GroupCallState = "discarded"
 )
 
+// GroupCallKind distinguishes regular channel group calls from ad-hoc
+// conference calls. Conference calls have no channel membership scope; access is
+// granted by creator/participant/invite/slug.
+type GroupCallKind string
+
+const (
+	GroupCallKindChannel    GroupCallKind = "channel"
+	GroupCallKindConference GroupCallKind = "conference"
+)
+
+// GroupCallInviteStatus is the durable state of a private conference invite.
+type GroupCallInviteStatus string
+
+const (
+	GroupCallInvitePending  GroupCallInviteStatus = "pending"
+	GroupCallInviteAccepted GroupCallInviteStatus = "accepted"
+	GroupCallInviteDeclined GroupCallInviteStatus = "declined"
+	GroupCallInviteMissed   GroupCallInviteStatus = "missed"
+	GroupCallInviteRevoked  GroupCallInviteStatus = "revoked"
+)
+
 // 群通话业务错误；rpc 层映射为 GROUPCALL_* RPC_ERROR。
 var (
 	ErrGroupCallInvalid        = errors.New("group call invalid")
@@ -21,6 +42,7 @@ var (
 	ErrGroupCallAlreadyStarted = errors.New("group call already started")
 	ErrGroupCallSSRCDuplicate  = errors.New("group call ssrc duplicate")
 	ErrGroupCallNotJoined      = errors.New("group call participant missing")
+	ErrConferenceChainInvalid  = errors.New("conference call chain invalid")
 )
 
 // GroupCall 是一场群通话的权威态。
@@ -29,6 +51,7 @@ type GroupCall struct {
 	AccessHash    int64
 	ChannelID     int64
 	CreatorUserID int64
+	Kind          GroupCallKind
 	State         GroupCallState
 	Title         string
 	JoinMuted     bool
@@ -41,6 +64,14 @@ type GroupCall struct {
 	// StartedMsgID 是 messageActionGroupCall(started) 的频道消息 id（discard 时
 	// 客户端用它定位起始服务消息，当前仅记录）。
 	StartedMsgID int
+	// InviteSlug/InviteLink 仅 conference 使用。slug 必须在 migrate reason 与
+	// InputGroupCallSlug 中稳定可解析；link 是客户端 UI 复制/分享用完整 URL。
+	InviteSlug string
+	InviteLink string
+	// RandomID 是 conference create 的幂等键（creator_user_id + random_id）。
+	RandomID int64
+	// MigratedFromPhoneCallID 记录由哪通 P2P call 升级而来；link-only create 为 0。
+	MigratedFromPhoneCallID int64
 }
 
 // Active 报告通话是否仍在进行。
@@ -48,6 +79,10 @@ func (c GroupCall) Active() bool {
 	return c.State == GroupCallStateActive
 }
 
+func (c GroupCall) Conference() bool {
+	return c.Kind == GroupCallKindConference
+}
+
 // GroupCallParticipant 是房间内一名参与者。
 type GroupCallParticipant struct {
 	CallID int64
@@ -67,7 +102,11 @@ type GroupCallParticipant struct {
 	// 快照（M3/M4 启用；M0/M1 仅透明保存 self-edit，不转发）。
 	VideoJSON        []byte
 	PresentationJSON []byte
-	Left             bool
+	// PublicKey/JoinBlock 仅 conference 使用。服务端不解析 E2E 内容，只持久化
+	//  opaque bytes 并供 chain block 补拉/转发。
+	PublicKey []byte
+	JoinBlock []byte
+	Left      bool
 	// LastCheckDate 是 checkGroupCall 保活水位。注意：客户端只在 Connecting 态
 	// 发 checkGroupCall（媒体连通后心跳停止），掉线判定必须与 SFU 媒体面活性
 	// 取双过期（见 sweeper），绝不能单凭此字段。
@@ -85,11 +124,13 @@ type CreateGroupCallRequest struct {
 
 // JoinGroupCallRequest 加入/重进群通话（rejoin 同主键换新 ssrc）。
 type JoinGroupCallRequest struct {
-	CallID  int64
-	UserID  int64
-	SSRC    int64
-	Muted   bool
-	IsAdmin bool
+	CallID    int64
+	UserID    int64
+	SSRC      int64
+	Muted     bool
+	IsAdmin   bool
+	PublicKey []byte
+	JoinBlock []byte
 	// VideoJSON 是本次 join 铸造的视频内部状态（endpoint+源组+active）；rejoin
 	// 整体替换并**清空旧 PresentationJSON**（客户端主连接 rejoin 后会重发
 	// joinGroupCallPresentation，旧屏幕登记必须作废）。
@@ -104,6 +145,27 @@ type GroupCallMutation struct {
 	Participant GroupCallParticipant
 }
 
+// RemoveConferenceCallParticipantsRequest describes a conference participant
+// removal from both the media participant set and the E2E member chain.
+type RemoveConferenceCallParticipantsRequest struct {
+	CallID        int64
+	AuthorUserID  int64
+	TargetUserIDs []int64
+	OnlyLeft      bool
+	Kick          bool
+	Block         []byte
+	Now           int
+}
+
+// RemoveConferenceCallParticipantsResult is the transactional result of
+// accepting a conference E2E removal block and/or kicking active participants.
+type RemoveConferenceCallParticipantsResult struct {
+	Call                GroupCall
+	ParticipantsChanged []GroupCallParticipant
+	ChainBlock          GroupCallChainBlock
+	ChainBlockAppended  bool
+}
+
 // GroupCallParticipantUpdate 是 editGroupCallParticipant 的字段级更新（nil=不动）。
 type GroupCallParticipantUpdate struct {
 	Muted            *bool
@@ -129,3 +191,33 @@ type GroupCallParticipantPage struct {
 	NextOffset   string
 	Version      int
 }
+
+// GroupCallInvite 是 conference call 在私聊中发出的邀请服务消息索引。
+type GroupCallInvite struct {
+	CallID        int64
+	InviterUserID int64
+	InviteeUserID int64
+	MessageID     int
+	Status        GroupCallInviteStatus
+	Video         bool
+	CreatedAt     int
+	UpdatedAt     int
+}
+
+// GroupCallChainBlockLatestOffset 是客户端用来请求当前 sub-chain 最新 block 的哨兵值。
+const GroupCallChainBlockLatestOffset = -1
+
+// GroupCallChainBlock 是 conference E2E chain 的 opaque block。
+type GroupCallChainBlock struct {
+	CallID       int64
+	SubChainID   int
+	Offset       int
+	AuthorUserID int64
+	Block        []byte
+	CreatedAt    int
+}
+
+type GroupCallChainBlockPage struct {
+	Blocks     []GroupCallChainBlock
+	NextOffset int
+}