remark42/backend/vendor/github.com/slack-go/slack/admin_teams.go

package slack

import (
	"context"
	"net/url"
	"strings"
)

// AdminTeamSettings contains workspace settings returned by admin.teams.settings.info.
type AdminTeamSettings struct {
	ID               string           `json:"id"`
	Name             string           `json:"name"`
	URL              string           `json:"url"`
	Domain           string           `json:"domain"`
	EmailDomain      string           `json:"email_domain"`
	AvatarBaseURL    string           `json:"avatar_base_url"`
	IsVerified       bool             `json:"is_verified"`
	Icon             TeamSettingsIcon `json:"icon"`
	EnterpriseID     string           `json:"enterprise_id"`
	EnterpriseName   string           `json:"enterprise_name"`
	EnterpriseDomain string           `json:"enterprise_domain"`
	DefaultChannels  []string         `json:"default_channels"`
}

// TeamSettingsIcon contains team icon URLs and a default flag.
type TeamSettingsIcon struct {
	ImageDefault bool   `json:"image_default"`
	Image34      string `json:"image_34"`
	Image44      string `json:"image_44"`
	Image68      string `json:"image_68"`
	Image88      string `json:"image_88"`
	Image102     string `json:"image_102"`
	Image132     string `json:"image_132"`
	Image230     string `json:"image_230"`
}

// TeamDiscoverability represents the discoverability setting for a workspace.
type TeamDiscoverability string

const (
	TeamDiscoverabilityOpen       TeamDiscoverability = "open"
	TeamDiscoverabilityInviteOnly TeamDiscoverability = "invite_only"
	TeamDiscoverabilityClosed     TeamDiscoverability = "closed"
	TeamDiscoverabilityUnlisted   TeamDiscoverability = "unlisted"
)

type adminTeamSettingsInfoResponse struct {
	Team AdminTeamSettings `json:"team"`
	SlackResponse
}

// AdminTeamsSettingsInfo returns workspace settings.
// Slack API docs: https://docs.slack.dev/reference/methods/admin.teams.settings.info
func (api *Client) AdminTeamsSettingsInfo(ctx context.Context, teamID string) (*AdminTeamSettings, error) {
	values := url.Values{
		"token":   {api.token},
		"team_id": {teamID},
	}

	response := &adminTeamSettingsInfoResponse{}
	err := api.postMethod(ctx, "admin.teams.settings.info", values, response)
	if err != nil {
		return nil, err
	}

	return &response.Team, response.Err()
}

// AdminTeamsSettingsSetDefaultChannels sets the default channels for a workspace.
// Slack API docs: https://docs.slack.dev/reference/methods/admin.teams.settings.setDefaultChannels
func (api *Client) AdminTeamsSettingsSetDefaultChannels(ctx context.Context, teamID string, channelIDs ...string) error {
	values := url.Values{
		"token":       {api.token},
		"team_id":     {teamID},
		"channel_ids": {strings.Join(channelIDs, ",")},
	}

	response := &SlackResponse{}
	err := api.postMethod(ctx, "admin.teams.settings.setDefaultChannels", values, response)
	if err != nil {
		return err
	}
	return response.Err()
}

// AdminTeamsSettingsSetDescription sets the description for a workspace.
// Slack API docs: https://docs.slack.dev/reference/methods/admin.teams.settings.setDescription
func (api *Client) AdminTeamsSettingsSetDescription(ctx context.Context, teamID, description string) error {
	values := url.Values{
		"token":       {api.token},
		"team_id":     {teamID},
		"description": {description},
	}

	response := &SlackResponse{}
	err := api.postMethod(ctx, "admin.teams.settings.setDescription", values, response)
	if err != nil {
		return err
	}
	return response.Err()
}

// AdminTeamsSettingsSetDiscoverability sets the discoverability for a workspace.
// The discoverability parameter must be one of: open, invite_only, closed, or unlisted.
// Slack API docs: https://docs.slack.dev/reference/methods/admin.teams.settings.setDiscoverability
func (api *Client) AdminTeamsSettingsSetDiscoverability(ctx context.Context, teamID string, discoverability TeamDiscoverability) error {
	values := url.Values{
		"token":           {api.token},
		"team_id":         {teamID},
		"discoverability": {string(discoverability)},
	}

	response := &SlackResponse{}
	err := api.postMethod(ctx, "admin.teams.settings.setDiscoverability", values, response)
	if err != nil {
		return err
	}
	return response.Err()
}

// AdminTeamsSettingsSetIcon sets the icon for a workspace.
// Slack API docs: https://docs.slack.dev/reference/methods/admin.teams.settings.setIcon
func (api *Client) AdminTeamsSettingsSetIcon(ctx context.Context, teamID, imageURL string) error {
	values := url.Values{
		"token":     {api.token},
		"team_id":   {teamID},
		"image_url": {imageURL},
	}

	response := &SlackResponse{}
	err := api.postMethod(ctx, "admin.teams.settings.setIcon", values, response)
	if err != nil {
		return err
	}
	return response.Err()
}

// AdminTeamsSettingsSetName sets the name for a workspace.
// Slack API docs: https://docs.slack.dev/reference/methods/admin.teams.settings.setName
func (api *Client) AdminTeamsSettingsSetName(ctx context.Context, teamID, name string) error {
	values := url.Values{
		"token":   {api.token},
		"team_id": {teamID},
		"name":    {name},
	}

	response := &SlackResponse{}
	err := api.postMethod(ctx, "admin.teams.settings.setName", values, response)
	if err != nil {
		return err
	}
	return response.Err()
}