opencloud/pkg/jmap/api_contact.go

package jmap

import "github.com/opencloud-eu/opencloud/pkg/jscontact"

var NS_CONTACTS = ns(JmapContacts)

var DEFAULT_CONTACT_CARD_VERSION = jscontact.JSContactVersion_1_0

func (j *Client) GetContactCards(accountId string, contactIds []string, ctx Context) (Result[ContactCardGetResponse], Error) {
	return get(j, "GetContactCards", ContactCardType,
		func(accountId string, ids []string) ContactCardGetCommand {
			return ContactCardGetCommand{AccountId: accountId, Ids: contactIds}
		},
		ContactCardGetResponse{},
		identity1,
		accountId, contactIds,
		ctx,
	)
}

type ContactCardChanges ChangesTemplate[ContactCard]

var _ Changes[ContactCard] = ContactCardChanges{}

func (c ContactCardChanges) GetHasMoreChanges() bool   { return c.HasMoreChanges }
func (c ContactCardChanges) GetOldState() State        { return c.OldState }
func (c ContactCardChanges) GetNewState() State        { return c.NewState }
func (c ContactCardChanges) GetCreated() []ContactCard { return c.Created }
func (c ContactCardChanges) GetUpdated() []ContactCard { return c.Updated }
func (c ContactCardChanges) GetDestroyed() []string    { return c.Destroyed }

// Retrieve the changes in Contact Cards since a given State.
// @api:tags contact,changes
func (j *Client) GetContactCardChanges(accountId string, sinceState State, maxChanges uint, ctx Context) (Result[ContactCardChanges], Error) {
	return changes(j, "GetContactCardChanges", ContactCardType,
		func() ContactCardChangesCommand {
			return ContactCardChangesCommand{AccountId: accountId, SinceState: sinceState, MaxChanges: uintPtr(maxChanges)}
		},
		ContactCardChangesResponse{},
		func(path string, rof string) ContactCardGetRefCommand {
			return ContactCardGetRefCommand{
				AccountId: accountId,
				IdsRef: &ResultReference{
					Name:     CommandContactCardChanges,
					Path:     path,
					ResultOf: rof,
				},
			}
		},
		func(resp ContactCardGetResponse) []ContactCard { return resp.List },
		func(oldState, newState State, hasMoreChanges bool, created, updated []ContactCard, destroyed []string) ContactCardChanges {
			return ContactCardChanges{
				OldState:       oldState,
				NewState:       newState,
				HasMoreChanges: hasMoreChanges,
				Created:        created,
				Updated:        updated,
				Destroyed:      destroyed,
			}
		},
		ctx,
	)
}

type ContactCardSearchResults SearchResultsTemplate[ContactCard]

var _ SearchResults[ContactCard] = &ContactCardSearchResults{}

func (r *ContactCardSearchResults) GetResults() []ContactCard { return r.Results }
func (r *ContactCardSearchResults) GetCanCalculateChanges() ChangeCalculation {
	return r.CanCalculateChanges
}
func (r *ContactCardSearchResults) GetPosition() *uint         { return r.Position }
func (r *ContactCardSearchResults) GetLimit() *uint            { return r.Limit }
func (r *ContactCardSearchResults) GetTotal() *uint            { return r.Total }
func (r *ContactCardSearchResults) RemoveResults()             { r.Results = nil }
func (r *ContactCardSearchResults) SetLimit(limit *uint)       { r.Limit = limit }
func (r *ContactCardSearchResults) SetPosition(position *uint) { r.Position = position }

func (j *Client) QueryContactCards(accountIds []string, //NOSONAR
	filter ContactCardFilterElement, sortBy []ContactCardComparator,
	position int, anchor string, anchorOffset *int, limit *uint, calculateTotal bool,
	ctx Context) (Result[map[string]*ContactCardSearchResults], Error) {
	return queryN(j, "QueryContactCards", ContactCardType,
		[]ContactCardComparator{{Property: ContactCardPropertyUpdated, IsAscending: false}},
		func(accountId string, filter ContactCardFilterElement, sortBy []ContactCardComparator, position int, anchor string, anchorOffset *int, limit *uint) ContactCardQueryCommand {
			return ContactCardQueryCommand{AccountId: accountId, Filter: filter, Sort: sortBy, Position: position, Anchor: anchor, AnchorOffset: anchorOffset, Limit: limit, CalculateTotal: calculateTotal}
		},
		func(accountId string, cmd Command, path string, rof string) ContactCardGetRefCommand {
			return ContactCardGetRefCommand{AccountId: accountId, IdsRef: &ResultReference{Name: cmd, Path: path, ResultOf: rof}}
		},
		func(query ContactCardQueryResponse, get ContactCardGetResponse) *ContactCardSearchResults {
			return &ContactCardSearchResults{
				Results:             get.List,
				CanCalculateChanges: ChangeCalculation(query.CanCalculateChanges),
				Position:            ptrIf(query.Position, anchor == ""),
				Total:               valueIf(query.Total, calculateTotal),
				Limit:               ptrIf(query.Limit, limit != nil),
			}
		},
		accountIds,
		filter, sortBy, position, anchor, anchorOffset, limit, ctx,
	)
}

// @api:example create
func (j *Client) CreateContactCard(accountId string, contact ContactCardChange, ctx Context) (Result[*ContactCard], Error) {
	if contact.Version == nil {
		contact.Version = &DEFAULT_CONTACT_CARD_VERSION
	}
	return create(j, "CreateContactCard", ContactCardType,
		func(accountId string, create map[string]ContactCardChange) ContactCardSetCommand {
			return ContactCardSetCommand{AccountId: accountId, Create: create}
		},
		func(accountId string, ids string) ContactCardGetCommand {
			return ContactCardGetCommand{AccountId: accountId, Ids: []string{ids}}
		},
		func(resp ContactCardSetResponse) map[string]*ContactCard {
			return resp.Created
		},
		func(resp ContactCardGetResponse) []ContactCard {
			return resp.List
		},
		accountId, contact,
		ctx,
	)
}

func (j *Client) DeleteContactCard(accountId string, destroyIds []string, ctx Context) (Result[map[string]SetError], Error) {
	return destroy(j, "DeleteContactCard", ContactCardType,
		func(accountId string, destroy []string) ContactCardSetCommand {
			return ContactCardSetCommand{AccountId: accountId, Destroy: destroy}
		},
		ContactCardSetResponse{},
		accountId, destroyIds,
		ctx,
	)
}

// @api:example update
func (j *Client) UpdateContactCard(accountId string, id string, changes ContactCardChange, ctx Context) (Result[ContactCard], Error) {
	return update(j, "UpdateContactCard", ContactCardType,
		func(update map[string]PatchObject) ContactCardSetCommand {
			return ContactCardSetCommand{AccountId: accountId, Update: update}
		},
		func(id string) ContactCardGetCommand {
			return ContactCardGetCommand{AccountId: accountId, Ids: []string{id}}
		},
		func(resp ContactCardSetResponse) map[string]SetError { return resp.NotUpdated },
		func(resp ContactCardGetResponse) ContactCard { return resp.List[0] },
		id, changes,
		ctx,
	)
}