patient.go

package hint

import (
	"errors"
	"fmt"
	"strconv"
	"time"
)

const (
	PhoneTypeMobile = "mobile"
	PhoneTypeOffice = "office"
	PhoneTypeHome   = "home"

	// membership states retreived from http://support.hint.com/knowledgebase/articles/804717-membership-statuses
	MembershipStatusActive      = "active"
	MembershipStatusArchived    = "archived"
	MembershipStatusEnded       = "ended"
	MembershipStatusInactive    = "inactive"
	MembershipStatusPending     = "pending"
	MembershipStatusUnconfirmed = "unconfirmed"
	MembershipStatusUnpaid      = "unpaid"
)

type Language string

var (
	LanguageEnglish Language = "en"
	LanguageSpanish Language = "es"
)

var (
	AvailableMembershipStatuses = []string{
		MembershipStatusActive,
		MembershipStatusArchived,
		MembershipStatusEnded,
		MembershipStatusInactive,
		MembershipStatusPending,
		MembershipStatusUnconfirmed,
		MembershipStatusUnpaid,
	}
)

// Phone represents a typed phone number
type Phone struct {
	Type   string `json:"type"`
	Number string `json:"number"`
}

// PatientParams represents the mutable fields of a patient.
type PatientParams struct {
	FirstName                string        `json:"first_name,omitempty"`
	LastName                 string        `json:"last_name,omitempty"`
	Email                    string        `json:"email,omitempty"`
	Gender                   string        `json:"gender,omitempty"`
	DOB                      string        `json:"dob,omitempty"`
	HealthInsuranceGroupID   string        `json:"health_insurance_group_id,omitempty"`
	HealthInsuranceMemberID  string        `json:"health_insurance_member_id,omitempty"`
	HealthInsurancePayerName string        `json:"health_insurance_payer_name,omitempty"`
	HealthInsurancePayerID   string        `json:"health_insurance_payer_id,omitempty"`
	AddressLine1             string        `json:"address_line_1,omitempty"`
	AddressLine2             string        `json:"address_line_2,omitempty"`
	AddressCity              string        `json:"address_city,omitempty"`
	AddressState             string        `json:"address_state,omitempty"`
	AddressZip               string        `json:"address_zip,omitempty"`
	AddressCountry           string        `json:"address_country,omitempty"`
	ExternalSourceID         string        `json:"external_source_id,omitempty"`
	ExternalSourceName       string        `json:"external_source_name,omitempty"`
	ExternalLinkID           string        `json:"external_link_id,omitempty"`
	IntegrationRecordID      string        `json:"integration_record_id,omitempty"`
	IntegrationSyncStatus    string        `json:"integration_sync_status,omitempty"`
	IntegrationErrorMessage  string        `json:"integration_error_message,omitempty"`
	IntegrationWebLink       string        `json:"integration_web_link,omitempty"`
	Phones                   []*Phone      `json:"phones,omitempty"`
	Practitioner             *Practitioner `json:"practitioner,omitempty"`
	PreferredLanguage        Language      `json:"preferred_language,omitempty"`
}

// Validate ensures that the required fields in when creating
// or updating a patient are present.
func (p *PatientParams) Validate() error {
	if p.FirstName == "" {
		return errors.New("first_name required")
	} else if p.LastName == "" {
		return errors.New("last_name required")
	}
	return nil
}

// Patient represents a patient registered as part of a practice on hint.
type Patient struct {
	ID                       string        `json:"id"`
	CreatedAt                time.Time     `json:"created_at,omitempty"`
	UpdatedAt                time.Time     `json:"updated_at,omitempty"`
	FirstName                string        `json:"first_name,omitempty"`
	LastName                 string        `json:"last_name,omitempty"`
	Name                     string        `json:"name,omitempty"`
	Email                    string        `json:"email,omitempty"`
	DOB                      string        `json:"dob,omitempty"`
	Age                      int           `json:"age,omitempty"`
	Gender                   string        `json:"gender,omitempty"`
	MembershipStatus         string        `json:"membership_status,omitempty"`
	JoinedPracticeDate       string        `json:"date,omitempty"`
	ExternalSourceID         string        `json:"external_source_id,omitempty"`
	ExternalSourceName       string        `json:"external_source_name,omitempty"`
	ExternalLinkID           string        `json:"external_link_id,omitempty"`
	Practitioner             *Practitioner `json:"practitioner,omitempty"`
	HealthInsuranceGroupID   string        `json:"health_insurance_group_id,omitempty"`
	HealthInsuranceMemberID  string        `json:"health_insurance_member_id,omitempty"`
	HealthInsurancePayerName string        `json:"health_insurance_payer_name,omitempty"`
	HealthInsurancePayerID   string        `json:"health_insurance_payer_id,omitempty"`
	Phones                   []*Phone      `json:"phones,omitempty"`
	AddressLine1             string        `json:"address_line_1,omitempty"`
	AddressLine2             string        `json:"address_line_2,omitempty"`
	AddressZip               string        `json:"address_zip,omitempty"`
	AddressCity              string        `json:"address_city,omitempty"`
	AddressState             string        `json:"address_state,omitempty"`
	AddressCountry           string        `json:"address_country,omitempty"`
	ProviderWebLink          string        `json:"provider_web_link,omitempty"`
	Memberships              []*Membership `json:"memberships"`
	IntegrationRecordID      string        `json:"integration_record_id"`
	IntegrationSyncStatus    string        `json:"integration_sync_status"`
	IntegrationErrorMessage  string        `json:"integration_error_message"`
	IntegrationWebLink       string        `json:"integration_web_link"`
	Location                 *Location     `json:"location,omitempty"`
	PreferredLanguage        Language      `json:"preferred_language,omitempty"`
}

func PatientURLForProvider(id string) string {
	return ProviderURL() + "/patients/" + id
}

type PatientClient interface {
	New(practiceKey string, params *PatientParams) (*Patient, error)
	Get(practiceKey, id string) (*Patient, error)
	Update(practiceKey, id string, params *PatientParams) (*Patient, error)
	Delete(practiceKey, id string) error
	List(practiceKey string, params *ListParams) *Iter
}

type patientClient struct {
	B   Backend
	Key string
}

func NewPatientClient(backend Backend, key string) PatientClient {
	return &patientClient{
		B:   backend,
		Key: key,
	}
}

func (c patientClient) New(practiceKey string, params *PatientParams) (*Patient, error) {
	if practiceKey == "" {
		return nil, errors.New("practice_key required")
	}

	patient := &Patient{}
	if _, err := c.B.Call("POST", "/provider/patients", practiceKey, params, patient); err != nil {
		return nil, err
	}

	return patient, nil
}

func (c patientClient) Get(practiceKey, id string) (*Patient, error) {
	if practiceKey == "" {
		return nil, errors.New("practice_key required")
	}

	patient := &Patient{}
	if _, err := c.B.Call("GET", fmt.Sprintf("/provider/patients/%s", id), practiceKey, nil, patient); err != nil {
		return nil, err
	}
	return patient, nil
}

func (c patientClient) Update(practiceKey, id string, params *PatientParams) (*Patient, error) {
	if practiceKey == "" {
		return nil, errors.New("practice_key required")
	}

	patient := &Patient{}
	if _, err := c.B.Call("PATCH", fmt.Sprintf("/provider/patients/%s", id), practiceKey, params, patient); err != nil {
		return nil, err
	}

	return patient, nil
}

func (c patientClient) Delete(practiceKey, id string) error {
	if practiceKey == "" {
		return errors.New("practice_key required")
	}

	if _, err := c.B.Call("DELETE", fmt.Sprintf("/provider/patients/%s", id), practiceKey, nil, nil); err != nil {
		return err
	}

	return nil
}

func (c patientClient) List(practiceKey string, params *ListParams) *Iter {
	return GetIter(params, func(lp *ListParams) ([]interface{}, ListMeta, error) {
		var meta ListMeta

		encodedParams, err := lp.Encode()
		if err != nil {
			return nil, meta, err
		}

		var patients []*Patient
		resHeaders, err := c.B.Call("GET", fmt.Sprintf("provider/patients?%s", encodedParams), practiceKey, nil, &patients)
		if err != nil {
			return nil, meta, err
		}

		if xCountHeader := resHeaders.Get("x-count"); xCountHeader != "" {
			meta.CurrentCount, err = strconv.ParseUint(xCountHeader, 10, 64)
			if err != nil {
				return nil, meta, err
			}
		}

		if xTotalCountHeader := resHeaders.Get("x-total-count"); xTotalCountHeader != "" {
			meta.TotalCount, err = strconv.ParseUint(xTotalCountHeader, 10, 64)
			if err != nil {
				return nil, meta, err
			}
		}

		ret := make([]interface{}, len(patients))
		for i, patient := range patients {
			ret[i] = patient
		}

		return ret, meta, nil
	})
}