metafield.go

package goshopify

import (
	"fmt"
	"time"
)

// MetafieldService is an interface for interfacing with the metafield endpoints
// of the Shopify API.
// https://help.shopify.com/api/reference/metafield
type MetafieldService interface {
	List(interface{}) ([]Metafield, error)
	Count(interface{}) (int, error)
	Get(int64, interface{}) (*Metafield, error)
	Create(Metafield) (*Metafield, error)
	Update(Metafield) (*Metafield, error)
	Delete(int64) error
}

// MetafieldsService is an interface for other Shopify resources
// to interface with the metafield endpoints of the Shopify API.
// https://help.shopify.com/api/reference/metafield
type MetafieldsService interface {
	ListMetafields(int64, interface{}) ([]Metafield, error)
	CountMetafields(int64, interface{}) (int, error)
	GetMetafield(int64, int64, interface{}) (*Metafield, error)
	CreateMetafield(int64, Metafield) (*Metafield, error)
	UpdateMetafield(int64, Metafield) (*Metafield, error)
	DeleteMetafield(int64, int64) error
}

// MetafieldServiceOp handles communication with the metafield
// related methods of the Shopify API.
type MetafieldServiceOp struct {
	client     *Client
	resource   string
	resourceID int64
}

type metafieldType string

// https://shopify.dev/docs/api/admin-rest/2023-07/resources/metafield#resource-object
const (
	//True or false.
	MetafieldTypeBoolean metafieldType = "boolean"

	//A hexidecimal color code, #fff123.
	MetafieldTypeColor metafieldType = "color" //#fff123

	//ISO601, YYYY-MM-DD.
	MetafieldTypeDate metafieldType = "date"

	//ISO8601, YYYY-MM-DDTHH:MM:SS.
	MetafieldTypeDatetime metafieldType = "date_time"

	//JSON, {"value:" 25.0, "unit": "cm"}.
	MetafieldTypeDimension metafieldType = "dimension"

	//{"ingredient": "flour", "amount": 0.3}.
	MetafieldTypeJSON metafieldType = "json"

	//JSON, {"amount": 5.99, "currency_code": "CAD"}.
	MetafieldTypeMoney metafieldType = "money"

	//lines of text separated with newline characters.
	MetafieldTypeMultiLineTextField metafieldType = "multi_line_text_field"

	//10.4.
	MetafieldTypeNumberDecimal metafieldType = "number_decimal"

	//10.
	MetafieldTypeNumberInteger metafieldType = "number_integer"

	//JSON, {"value": "3.5", "scale_min": "1.0", "scale_max": "5.0"}.
	MetafieldTypeRating metafieldType = "rating"

	//JSON, {"type": "root","children": [{"type": "paragraph","children": [{"type": "text","value": "Bold text.","bold": true}]}]}.
	MetafieldTypeRichTextField metafieldType = "rich_text_field"

	//A single line of text. Do not use for numbers or dates, use correct type instead!
	MetafieldTypeSingleLineTextField metafieldType = "single_line_text_field"

	//https, http, mailto, sms, or tel.
	MetafieldTypeURL metafieldType = "url"

	//JSON, {"value:" 20.0, "unit": "ml"}.
	MetafieldTypeVolume metafieldType = "volume"

	//JSON, {"value:" 2.5, "unit": "kg"}.
	MetafieldTypeWeight metafieldType = "weight"
)

// Metafield represents a Shopify metafield.
type Metafield struct {
	CreatedAt         *time.Time    `json:"created_at,omitempty"`
	Description       string        `json:"description,omitempty"`    //Description of the metafield.
	ID                int64         `json:"id,omitempty"`             //Assigned by Shopify, used for updating a metafield.
	Key               string        `json:"key,omitempty"`            //The unique identifier for a metafield within its namespace, 3-64 characters long.
	Namespace         string        `json:"namespace,omitempty"`      //The container for a group of metafields, 3-255 characters long.
	OwnerId           int64         `json:"owner_id,omitempty"`       //The unique ID of the resource the metafield is for, i.e.: an Order ID.
	OwnerResource     string        `json:"owner_resource,omitempty"` //The type of reserouce the metafield is for, i.e.: and Order.
	UpdatedAt         *time.Time    `json:"updated_at,omitempty"`     //
	Value             interface{}   `json:"value,omitempty"`          //The data stored in the metafield. Always stored as a string, use Type field for actual data type.
	Type              metafieldType `json:"type,omitempty"`           //One of Shopify's defined types, see metafieldType.
	AdminGraphqlAPIID string        `json:"admin_graphql_api_id,omitempty"`
}

// MetafieldResource represents the result from the metafields/X.json endpoint
type MetafieldResource struct {
	Metafield *Metafield `json:"metafield"`
}

// MetafieldsResource represents the result from the metafields.json endpoint
type MetafieldsResource struct {
	Metafields []Metafield `json:"metafields"`
}

// List metafields
func (s *MetafieldServiceOp) List(options interface{}) ([]Metafield, error) {
	prefix := MetafieldPathPrefix(s.resource, s.resourceID)
	path := fmt.Sprintf("%s.json", prefix)
	resource := new(MetafieldsResource)
	err := s.client.Get(path, resource, options)
	return resource.Metafields, err
}

// Count metafields
func (s *MetafieldServiceOp) Count(options interface{}) (int, error) {
	prefix := MetafieldPathPrefix(s.resource, s.resourceID)
	path := fmt.Sprintf("%s/count.json", prefix)
	return s.client.Count(path, options)
}

// Get individual metafield
func (s *MetafieldServiceOp) Get(metafieldID int64, options interface{}) (*Metafield, error) {
	prefix := MetafieldPathPrefix(s.resource, s.resourceID)
	path := fmt.Sprintf("%s/%d.json", prefix, metafieldID)
	resource := new(MetafieldResource)
	err := s.client.Get(path, resource, options)
	return resource.Metafield, err
}

// Create a new metafield
func (s *MetafieldServiceOp) Create(metafield Metafield) (*Metafield, error) {
	prefix := MetafieldPathPrefix(s.resource, s.resourceID)
	path := fmt.Sprintf("%s.json", prefix)
	wrappedData := MetafieldResource{Metafield: &metafield}
	resource := new(MetafieldResource)
	err := s.client.Post(path, wrappedData, resource)
	return resource.Metafield, err
}

// Update an existing metafield
func (s *MetafieldServiceOp) Update(metafield Metafield) (*Metafield, error) {
	prefix := MetafieldPathPrefix(s.resource, s.resourceID)
	path := fmt.Sprintf("%s/%d.json", prefix, metafield.ID)
	wrappedData := MetafieldResource{Metafield: &metafield}
	resource := new(MetafieldResource)
	err := s.client.Put(path, wrappedData, resource)
	return resource.Metafield, err
}

// Delete an existing metafield
func (s *MetafieldServiceOp) Delete(metafieldID int64) error {
	prefix := MetafieldPathPrefix(s.resource, s.resourceID)
	return s.client.Delete(fmt.Sprintf("%s/%d.json", prefix, metafieldID))
}