// Package group 定义 DEVELOPMENT 第 6.7 节群操作的接口。
package group

import (
	"context"
	"errors"

	"git.asio.asia/nixevol/NixMsg/internal/protocol"
)

// ErrNotImplemented 表示假实现未提供业务能力。
var ErrNotImplemented = errors.New("group: not implemented")

// MemberFail 是建群/加人时部分失败的项。
type MemberFail struct {
	ID   string `json:"id"`
	Code string `json:"code"`
}

// CreateResult 是建群结果。
type CreateResult struct {
	ID      string       `json:"id"`
	Name    string       `json:"name"`
	OwnerID string       `json:"owner_id"`
	Failed  []MemberFail `json:"failed,omitempty"`
}

// AddResult 是加人结果。
type AddResult struct {
	Failed []MemberFail `json:"failed,omitempty"`
}

// ListItem 是 group.list 一项。
type ListItem struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	OwnerID     string `json:"owner_id"`
	MemberCount int    `json:"member_count"`
}

// MemberItem 是 group.get 成员项。
type MemberItem struct {
	ID     string `json:"id"`
	Name   string `json:"name"`
	Online bool   `json:"online"`
}

// GetResult 是群详情。
type GetResult struct {
	ID         string       `json:"id"`
	Name       string       `json:"name"`
	OwnerID    string       `json:"owner_id"`
	Members    []MemberItem `json:"members"`
	NextCursor string       `json:"next_cursor,omitempty"`
}

// Service 是群子系统契约（第 6.7 节）。
type Service interface {
	Create(ctx context.Context, actorID string, req *protocol.GroupCreate) (CreateResult, error)
	Add(ctx context.Context, actorID string, req *protocol.GroupAdd) (AddResult, error)
	Remove(ctx context.Context, actorID string, req *protocol.GroupRemove) error
	Leave(ctx context.Context, actorID string, req *protocol.GroupLeave) error
	Transfer(ctx context.Context, actorID string, req *protocol.GroupTransfer) error
	Rename(ctx context.Context, actorID string, req *protocol.GroupRename) error
	Dissolve(ctx context.Context, actorID string, req *protocol.GroupDissolve) error
	List(ctx context.Context, actorID string, req *protocol.GroupList) (items []ListItem, nextCursor string, err error)
	Get(ctx context.Context, actorID string, req *protocol.GroupGet) (GetResult, error)

	// AdminCreate 后台建群（不要求对话密码）。
	AdminCreate(ctx context.Context, name string, ownerID string, memberIDs []string) (CreateResult, error)
	// AdminAddMembers 后台加人。
	AdminAddMembers(ctx context.Context, groupID string, memberIDs []string) (AddResult, error)
}