users.go

package zoom

import (
	"context"
	"encoding/json"
	"fmt"
	"net/http"
	"net/url"
	"time"
)

const (
	UsersActionAutoCreate UsersCreateAction = "autoCreate"
	UsersActionCreate     UsersCreateAction = "create"
	UsersActionCustCreate UsersCreateAction = "custCreate"
	UsersActionSSOCreate  UsersCreateAction = "ssoCreate"

	UsersRecordingFileTypeCC         UsersRecordingFileType = "CC"
	UsersRecordingFileTypeChat       UsersRecordingFileType = "CHAT"
	UsersRecordingFileTypeCSV        UsersRecordingFileType = "CSV"
	UsersRecordingFileTypeM4A        UsersRecordingFileType = "M4A"
	UsersRecordingFileTypeMP4        UsersRecordingFileType = "MP4"
	UsersRecordingFileTypeSummary    UsersRecordingFileType = "SUMMARY"
	UsersRecordingFileTypeTimeline   UsersRecordingFileType = "TIMELINE"
	UsersRecordingFileTypeTranscript UsersRecordingFileType = "TRANSCRIPT"

	UsersRecordingStatusCompleted  UsersRecordingStatus = "completed"
	UsersRecordingStatusProcessing UsersRecordingStatus = "processing"
)

type UsersCreateAction string

func (u UsersCreateAction) String() string {
	return string(u)
}

type UsersRecordingFileType string
type UsersRecordingStatus string

type UsersServicer interface {
	AddGroupMembers(ctx context.Context, groupID string, opts *UsersAddGroupMembersOptions) (*http.Response, error)
	Create(ctx context.Context, opts *UsersCreateOptions) (*UsersCreateResponse, *http.Response, error)
	Delete(ctx context.Context, userID string, opts *UsersDeleteOptions) (*http.Response, error)
	List(ctx context.Context, opts *UsersListOptions) (*UsersListResponse, *http.Response, error)
	ListRecordings(ctx context.Context, userID string, opts *UsersListRecordingsOptions) (*UsersListRecordingsResponse, *http.Response, error)
}

type UsersService struct {
	client *Client
}

var _ UsersServicer = (*UsersService)(nil)

type UsersAddGroupMembersOptions struct {
	Members []*UsersAddGroupMembersOptionsMember `json:"members"`
}

type UsersAddGroupMembersOptionsMember struct {
	Email  string `json:"email"`
	UserID string `json:"id"`
}

func (u *UsersService) AddGroupMembers(ctx context.Context, groupID string, opts *UsersAddGroupMembersOptions) (*http.Response, error) {
	out := &UsersCreateResponse{}

	res, err := u.client.request(ctx, http.MethodPost, "/groups/"+url.PathEscape(groupID)+"/members", nil, opts, out)
	if err != nil {
		return res, fmt.Errorf("making request: %w", err)
	}

	return res, nil
}

type UsersCreateOptions struct {
	Action   UsersCreateAction           `json:"action"`
	UserInfo *UsersCreateOptionsUserInfo `json:"user_info"`
}

type UsersCreateOptionsUserInfo struct {
	DisplayName *string `json:"display_name,omitempty"`
	Email       string  `json:"email"`
	FirstName   *string `json:"first_name,omitempty"`
	LastName    *string `json:"last_name,omitempty"`
	Password    *string `json:"password,omitempty"`
	Type        int     `json:"type"`
}

type UsersCreateResponse struct {
	Email     string `json:"email"`
	FirstName string `json:"first_name"`
	ID        string `json:"id"`
	LastName  string `json:"last_name"`
	Type      int    `json:"type"`
}

func (u *UsersService) Create(ctx context.Context, opts *UsersCreateOptions) (*UsersCreateResponse, *http.Response, error) {
	out := &UsersCreateResponse{}

	res, err := u.client.request(ctx, http.MethodPost, "/users", nil, opts, out)
	if err != nil {
		return nil, res, fmt.Errorf("making request: %w", err)
	}

	return out, res, nil
}

type UsersDeleteOptions struct {
	Action *string `url:"action,omitempty"`
}

func (u *UsersService) Delete(ctx context.Context, userID string, opts *UsersDeleteOptions) (*http.Response, error) {
	res, err := u.client.request(ctx, http.MethodDelete, "/users/"+url.QueryEscape(userID), opts, nil, nil)
	if err != nil {
		return res, fmt.Errorf("making request: %w", err)
	}

	return res, nil
}

type UsersListOptions struct {
	*PaginationOptions `url:",omitempty"`

	IncludeFields *string `url:"include_fields,omitempty"`
	RoleID        *string `url:"role_id,omitempty"`
	Status        *string `url:"status,omitempty"`
}

type UsersListResponse struct {
	*PaginationResponse

	Users []*UsersListItem `json:"users"`
}

type UsersListItem struct {
	CustomAttributes  []*UsersListItemCustomAttribute `json:"custom_attributes"`
	Dept              string                          `json:"dept"`
	DisplayName       string                          `json:"display_name"`
	Email             string                          `json:"email"`
	EmployeeUniqueID  string                          `json:"employee_unique_id"`
	FirstName         string                          `json:"first_name"`
	GroupIDs          []string                        `json:"group_ids"`
	ID                string                          `json:"id"`
	ImGroupIDs        []string                        `json:"im_group_ids"`
	LastClientVersion string                          `json:"last_client_version"`
	LastLoginTime     time.Time                       `json:"last_login_time"`
	LastName          string                          `json:"last_name"`
	PlanUnitedType    string                          `json:"plan_united_type"`
	Pmi               int64                           `json:"pmi"`
	RoleID            string                          `json:"role_id"`
	Status            string                          `json:"status"`
	Timezone          string                          `json:"timezone"`
	Type              int                             `json:"type"`
	UserCreatedAt     time.Time                       `json:"user_created_at"`
	Verified          int                             `json:"verified"`
}

type UsersListItemCustomAttribute struct {
	Key   string `json:"key"`
	Name  string `json:"name"`
	Value string `json:"value"`
}

func (u *UsersService) List(ctx context.Context, opts *UsersListOptions) (*UsersListResponse, *http.Response, error) {
	out := &UsersListResponse{}

	res, err := u.client.request(ctx, http.MethodGet, "/users", opts, nil, out)
	if err != nil {
		return nil, res, fmt.Errorf("making request: %w", err)
	}

	return out, res, nil
}

type UsersListRecordingsOptions struct {
	*PaginationOptions `url:",omitempty"`

	MeetingID *int64 `url:"meeting_id,omitempty"`
}

type UsersListRecordingsResponse struct {
	*PaginationResponse

	Meetings []*UsersListRecordingsMeeting `json:"meetings"`
}

type UsersListRecordingsMeeting struct {
	HostID         string                     `json:"host_id"`
	ID             int64                      `json:"id"`
	RecordingFiles []*UsersListRecordingsFile `json:"recording_files"`
	StartTime      time.Time                  `json:"start_time"`
}

type EmptyTime struct {
	Time *time.Time
}

func (ct *EmptyTime) UnmarshalJSON(data []byte) error {
	if string(data) == `""` {
		ct.Time = nil
		return nil
	}

	var t time.Time
	if err := json.Unmarshal(data, &t); err != nil {
		return err
	}

	ct.Time = &t

	return nil
}

type UsersListRecordingsFile struct {
	DownloadURL    string                 `json:"download_url"`
	FileSize       int                    `json:"file_size"`
	FileType       UsersRecordingFileType `json:"file_type"`
	ID             string                 `json:"id"`
	MeetingID      string                 `json:"meeting_id"`
	RecordingEnd   EmptyTime              `json:"recording_end,omitempty"`
	RecordingStart time.Time              `json:"recording_start"`
	Status         UsersRecordingStatus   `json:"status"`
}

func (u *UsersService) ListRecordings(ctx context.Context, userID string, opts *UsersListRecordingsOptions) (*UsersListRecordingsResponse, *http.Response, error) {
	out := &UsersListRecordingsResponse{}

	res, err := u.client.request(ctx, http.MethodGet, "/users/"+url.QueryEscape(userID)+"/recordings", opts, nil, out)
	if err != nil {
		return nil, res, fmt.Errorf("making HTTP request: %w", err)
	}

	return out, res, nil
}