messaginggroupep

type AddMessagingGroupMemberEndpoint struct{}

type AddMessagingGroupMemberRequest struct {
	// Messaging group ID.
	GroupID string `path:"id" validate:"required"`
	// The kind of member being added, which decides whether `account_user_id` or `agent_config_id` is expected.
	MemberType constants.MessagingGroupMemberType `json:"member_type" validate:"required"`
	// The account user to add (required when `member_type` is `user`).
	AccountUserID field.Optional[string] `json:"account_user_id,omitzero"`
	// The agent to add (required when `member_type` is `agent`).
	AgentConfigID field.Optional[string] `json:"agent_config_id,omitzero"`
}

type CreateMessagingGroupEndpoint struct{}

type CreateMessagingGroupRequest struct {
	// The roster's display name.
	Name string `json:"name" validate:"required"`
	// The account users to include in the roster.
	MemberAccountUserIDs []string `json:"member_account_user_ids,omitzero"`
	// The agents to include in the roster.
	MemberAgentConfigIDs []string `json:"member_agent_config_ids,omitzero"`
}

type DeleteMessagingGroupEndpoint struct{}

type DeleteMessagingGroupRequest struct {
	// Messaging group ID.
	GroupID string `path:"id" validate:"required"`
}

type GetMessagingGroupEndpoint struct{}

type GetMessagingGroupRequest struct {
	// Messaging group ID.
	GroupID string `path:"id" validate:"required"`
}

type ListMessagingGroupsEndpoint struct{}

type ListMessagingGroupsRequest struct{}

type MessagingGroupSvc interface {
	CreateMessagingGroup(ctx context.Context, req *CreateMessagingGroupRequest) (*apiresource.MessagingGroup, *apierror.APIError)
	ListMessagingGroups(ctx context.Context, req *ListMessagingGroupsRequest) (*apiresource.List[apiresource.MessagingGroup], *apierror.APIError)
	GetMessagingGroup(ctx context.Context, req *GetMessagingGroupRequest) (*apiresource.MessagingGroup, *apierror.APIError)
	UpdateMessagingGroup(ctx context.Context, req *UpdateMessagingGroupRequest) (*apiresource.MessagingGroup, *apierror.APIError)
	DeleteMessagingGroup(ctx context.Context, req *DeleteMessagingGroupRequest) (*apiresource.EmptyResource, *apierror.APIError)
	AddMessagingGroupMember(ctx context.Context, req *AddMessagingGroupMemberRequest) (*apiresource.MessagingGroup, *apierror.APIError)
	RemoveMessagingGroupMember(ctx context.Context, req *RemoveMessagingGroupMemberRequest) (*apiresource.MessagingGroup, *apierror.APIError)
}

type MessagingGroupSvcConfig struct {
	// ChatClient (required) is the notification-service ChatService gRPC client.
	ChatClient pb.ChatServiceClient
}

type RemoveMessagingGroupMemberEndpoint struct{}

type RemoveMessagingGroupMemberRequest struct {
	// Messaging group ID.
	GroupID string `path:"id" validate:"required"`
	// The membership ID to remove (from the roster's `members`).
	MemberID string `path:"member_id" validate:"required"`
}

type UpdateMessagingGroupEndpoint struct{}

type UpdateMessagingGroupRequest struct {
	// Messaging group ID.
	GroupID string `path:"id" validate:"required"`
	// The roster's new display name.
	Name string `json:"name" validate:"required"`
}