[MM-53968] Includes mattermost-plugin-api into the mono repo (#24235)

Include https://github.com/mattermost/mattermost-plugin-api into the mono repo

Co-authored-by: Jesse Hallam <jesse.hallam@gmail.com>
Co-authored-by: Michael Kochell <mjkochell@gmail.com>
Co-authored-by: Alejandro García Montoro <alejandro.garciamontoro@gmail.com>
Co-authored-by: Ben Schumacher <ben.schumacher@mattermost.com>
Co-authored-by: Alex Dovenmuehle <alex.dovenmuehle@mattermost.com>
Co-authored-by: Michael Kochell <6913320+mickmister@users.noreply.github.com>
Co-authored-by: Christopher Poile <cpoile@gmail.com>
Co-authored-by: İlker Göktuğ Öztürk <ilkergoktugozturk@gmail.com>
Co-authored-by: Shota Gvinepadze <wineson@gmail.com>
Co-authored-by: Ali Farooq <ali.farooq0@pm.me>
Co-authored-by: Maria A Nunez <maria.nunez@mattermost.com>
Co-authored-by: Daniel Espino García <larkox@gmail.com>
Co-authored-by: Christopher Speller <crspeller@gmail.com>
Co-authored-by: Alex Dovenmuehle <adovenmuehle@gmail.com>
Co-authored-by: Szymon Gibała <szymongib@gmail.com>
Co-authored-by: Lev <1187448+levb@users.noreply.github.com>
Co-authored-by: Jason Frerich <jason.frerich@mattermost.com>
Co-authored-by: Agniva De Sarker <agnivade@yahoo.co.in>
Co-authored-by: Artur M. Wolff <artur.m.wolff@gmail.com>
Co-authored-by: Madhav Hugar <16546715+madhavhugar@users.noreply.github.com>
Co-authored-by: Joe <security.joe@pm.me>
Co-authored-by: Ibrahim Serdar Acikgoz <serdaracikgoz86@gmail.com>
Co-authored-by: José Peso <trilopin@users.noreply.github.com>

server/public/pluginapi/team.go

@@ -0,0 +1,231 @@
+package pluginapi
+
+import (
+	"bytes"
+	"io"
+
+	"github.com/mattermost/mattermost/server/public/model"
+	"github.com/mattermost/mattermost/server/public/plugin"
+)
+
+// TeamService exposes methods to manipulate teams and their members.
+type TeamService struct {
+	api plugin.API
+}
+
+// Get gets a team.
+//
+// Minimum server version: 5.2
+func (t *TeamService) Get(teamID string) (*model.Team, error) {
+	team, appErr := t.api.GetTeam(teamID)
+
+	return team, normalizeAppErr(appErr)
+}
+
+// GetByName gets a team by its name.
+//
+// Minimum server version: 5.2
+func (t *TeamService) GetByName(name string) (*model.Team, error) {
+	team, appErr := t.api.GetTeamByName(name)
+
+	return team, normalizeAppErr(appErr)
+}
+
+// TeamListOption is used to filter team listing.
+type TeamListOption func(*ListTeamsOptions)
+
+// ListTeamsOptions holds options about filter out team listing.
+type ListTeamsOptions struct {
+	UserID string
+}
+
+// FilterTeamsByUser option is used to filter teams by user.
+func FilterTeamsByUser(userID string) TeamListOption {
+	return func(o *ListTeamsOptions) {
+		o.UserID = userID
+	}
+}
+
+// List gets a list of teams by options.
+//
+// Minimum server version: 5.2
+// Minimum server version when LimitTeamsToUser() option is used: 5.6
+func (t *TeamService) List(options ...TeamListOption) ([]*model.Team, error) {
+	opts := ListTeamsOptions{}
+	for _, o := range options {
+		o(&opts)
+	}
+
+	var teams []*model.Team
+	var appErr *model.AppError
+	if opts.UserID != "" {
+		teams, appErr = t.api.GetTeamsForUser(opts.UserID)
+	} else {
+		teams, appErr = t.api.GetTeams()
+	}
+
+	return teams, normalizeAppErr(appErr)
+}
+
+// Search search a team.
+//
+// Minimum server version: 5.8
+func (t *TeamService) Search(term string) ([]*model.Team, error) {
+	teams, appErr := t.api.SearchTeams(term)
+
+	return teams, normalizeAppErr(appErr)
+}
+
+// Create creates a team.
+//
+// Minimum server version: 5.2
+func (t *TeamService) Create(team *model.Team) error {
+	createdTeam, appErr := t.api.CreateTeam(team)
+	if appErr != nil {
+		return normalizeAppErr(appErr)
+	}
+
+	*team = *createdTeam
+
+	return nil
+}
+
+// Update updates a team.
+//
+// Minimum server version: 5.2
+func (t *TeamService) Update(team *model.Team) error {
+	updatedTeam, appErr := t.api.UpdateTeam(team)
+	if appErr != nil {
+		return normalizeAppErr(appErr)
+	}
+
+	*team = *updatedTeam
+
+	return nil
+}
+
+// Delete deletes a team.
+//
+// Minimum server version: 5.2
+func (t *TeamService) Delete(teamID string) error {
+	return normalizeAppErr(t.api.DeleteTeam(teamID))
+}
+
+// GetIcon gets the team icon.
+//
+// Minimum server version: 5.6
+func (t *TeamService) GetIcon(teamID string) (io.Reader, error) {
+	contentBytes, appErr := t.api.GetTeamIcon(teamID)
+	if appErr != nil {
+		return nil, normalizeAppErr(appErr)
+	}
+
+	return bytes.NewReader(contentBytes), nil
+}
+
+// SetIcon sets the team icon.
+//
+// Minimum server version: 5.6
+func (t *TeamService) SetIcon(teamID string, content io.Reader) error {
+	contentBytes, err := io.ReadAll(content)
+	if err != nil {
+		return err
+	}
+
+	return normalizeAppErr(t.api.SetTeamIcon(teamID, contentBytes))
+}
+
+// DeleteIcon removes the team icon.
+//
+// Minimum server version: 5.6
+func (t *TeamService) DeleteIcon(teamID string) error {
+	return normalizeAppErr(t.api.RemoveTeamIcon(teamID))
+}
+
+// GetUsers lists users of the team.
+//
+// Minimum server version: 5.6
+func (t *TeamService) ListUsers(teamID string, page, count int) ([]*model.User, error) {
+	users, appErr := t.api.GetUsersInTeam(teamID, page, count)
+
+	return users, normalizeAppErr(appErr)
+}
+
+// ListUnreadForUser gets the unread message and mention counts for each team to which the given user belongs.
+//
+// Minimum server version: 5.6
+func (t *TeamService) ListUnreadForUser(userID string) ([]*model.TeamUnread, error) {
+	teamUnreads, appErr := t.api.GetTeamsUnreadForUser(userID)
+
+	return teamUnreads, normalizeAppErr(appErr)
+}
+
+// GetMember returns a specific membership.
+//
+// Minimum server version: 5.2
+func (t *TeamService) GetMember(teamID, userID string) (*model.TeamMember, error) {
+	teamMember, appErr := t.api.GetTeamMember(teamID, userID)
+
+	return teamMember, normalizeAppErr(appErr)
+}
+
+// ListMembers returns the memberships of a specific team.
+//
+// Minimum server version: 5.2
+func (t *TeamService) ListMembers(teamID string, page, perPage int) ([]*model.TeamMember, error) {
+	teamMembers, appErr := t.api.GetTeamMembers(teamID, page, perPage)
+
+	return teamMembers, normalizeAppErr(appErr)
+}
+
+// ListMembersForUser returns all team memberships for a user.
+//
+// Minimum server version: 5.10
+func (t *TeamService) ListMembersForUser(userID string, page, perPage int) ([]*model.TeamMember, error) {
+	teamMembers, appErr := t.api.GetTeamMembersForUser(userID, page, perPage)
+
+	return teamMembers, normalizeAppErr(appErr)
+}
+
+// CreateMember creates a team membership.
+//
+// Minimum server version: 5.2
+func (t *TeamService) CreateMember(teamID, userID string) (*model.TeamMember, error) {
+	teamMember, appErr := t.api.CreateTeamMember(teamID, userID)
+
+	return teamMember, normalizeAppErr(appErr)
+}
+
+// CreateMembers creates a team membership for all provided user ids.
+//
+// Minimum server version: 5.2
+func (t *TeamService) CreateMembers(teamID string, userIDs []string, requestorID string) ([]*model.TeamMember, error) {
+	teamMembers, appErr := t.api.CreateTeamMembers(teamID, userIDs, requestorID)
+
+	return teamMembers, normalizeAppErr(appErr)
+}
+
+// DeleteMember deletes a team membership.
+//
+// Minimum server version: 5.2
+func (t *TeamService) DeleteMember(teamID, userID, requestorID string) error {
+	return normalizeAppErr(t.api.DeleteTeamMember(teamID, userID, requestorID))
+}
+
+// UpdateMemberRoles updates the role for a team membership.
+//
+// Minimum server version: 5.2
+func (t *TeamService) UpdateMemberRoles(teamID, userID, newRoles string) (*model.TeamMember, error) {
+	teamMember, appErr := t.api.UpdateTeamMemberRoles(teamID, userID, newRoles)
+
+	return teamMember, normalizeAppErr(appErr)
+}
+
+// GetStats gets a team's statistics
+//
+// Minimum server version: 5.8
+func (t *TeamService) GetStats(teamID string) (*model.TeamStats, error) {
+	teamStats, appErr := t.api.GetTeamStats(teamID)
+
+	return teamStats, normalizeAppErr(appErr)
+}