Skip to content

Send and receive SMS messages using your Android phone programmatically via a simple HTTP API

2.8 KB
Raw Blame
package requests

import (
	"encoding/json"
	"strings"
	"time"

	"github.com/NdoleStudio/httpsms/pkg/entities"
	"github.com/google/uuid"
	"github.com/lib/pq"
)

// ContactItem is a single contact in a create request.
type ContactItem struct {
	Name         string            `json:"name" example:"Alice Smith"`
	Emails       []string          `json:"emails,omitempty"`
	PhoneNumbers []string          `json:"phone_numbers"`
	Properties   map[string]string `json:"properties,omitempty"`
}

// ContactStoreRequest creates one or many contacts.
type ContactStoreRequest struct {
	request
	Contacts []ContactItem `json:"contacts"`
}

// UnmarshalJSON accepts either a JSON array of contacts or {"contacts":[...]}.
func (input *ContactStoreRequest) UnmarshalJSON(data []byte) error {
	trimmed := strings.TrimSpace(string(data))
	if strings.HasPrefix(trimmed, "[") {
		var items []ContactItem
		if err := json.Unmarshal(data, &items); err != nil {
			return err
		}
		input.Contacts = items
		return nil
	}

	type alias ContactStoreRequest
	var wrapper alias
	if err := json.Unmarshal(data, &wrapper); err != nil {
		return err
	}

	input.Contacts = wrapper.Contacts
	return nil
}

// Sanitize trims and normalizes each contact item.
func (input ContactStoreRequest) Sanitize() ContactStoreRequest {
	for index := range input.Contacts {
		input.Contacts[index] = SanitizeContactItem(input.Contacts[index])
	}
	return input
}

// ToContacts converts the request into persistable entities.Contact records.
func (input *ContactStoreRequest) ToContacts(userID entities.UserID) []*entities.Contact {
	now := time.Now().UTC()
	contacts := make([]*entities.Contact, 0, len(input.Contacts))
	for _, item := range input.Contacts {
		properties := item.Properties
		if properties == nil {
			properties = map[string]string{}
		}

		contacts = append(contacts, &entities.Contact{
			ID:           uuid.New(),
			UserID:       userID,
			Name:         item.Name,
			Emails:       pq.StringArray(item.Emails),
			PhoneNumbers: pq.StringArray(item.PhoneNumbers),
			Properties:   entities.ContactProperties(properties),
			CreatedAt:    now,
			UpdatedAt:    now,
		})
	}
	return contacts
}

// SanitizeContactItem trims and normalizes a single contact item so the CSV
// upload and JSON create paths accept and normalize identical values (e.g. a
// phone number without a leading "+" or an email with mixed case/whitespace).
func SanitizeContactItem(item ContactItem) ContactItem {
	item.Name = strings.TrimSpace(item.Name)
	item.Emails = sanitizeUniqueStrings(item.Emails, func(value string) string {
		return strings.ToLower(strings.TrimSpace(value))
	})
	item.PhoneNumbers = sanitizeUniqueStrings(item.PhoneNumbers, func(value string) string {
		var base request
		return base.sanitizeAddress(value)
	})
	if item.Properties == nil {
		item.Properties = map[string]string{}
	}
	return item
}