homebox/backend/internal/core/currencies/currencies.go

// Package currencies provides a shared definition of currencies. This uses a global
// variable to hold the currencies.
package currencies

import (
	"bytes"
	_ "embed"
	"encoding/json"
	"io"
	"log"
	"slices"
	"strings"
	"sync"
)

//go:embed currencies.json
var defaults []byte

const (
	MinDecimals = 0
	MaxDecimals = 18
)

// clampDecimals ensures the decimals value is within a safe range [0, 18]
func clampDecimals(decimals int, code string) int {
	original := decimals
	if decimals < MinDecimals {
		decimals = MinDecimals
		log.Printf("WARNING: Currency %s had negative decimals (%d), normalized to %d", code, original, decimals)
	} else if decimals > MaxDecimals {
		decimals = MaxDecimals
		log.Printf("WARNING: Currency %s had excessive decimals (%d), normalized to %d", code, original, decimals)
	}
	return decimals
}

type CollectorFunc func() ([]Currency, error)

func CollectJSON(reader io.Reader) CollectorFunc {
	return func() ([]Currency, error) {
		var currencies []Currency
		err := json.NewDecoder(reader).Decode(&currencies)
		if err != nil {
			return nil, err
		}

		// Clamp decimals during collection to ensure early normalization
		for i := range currencies {
			currencies[i].Decimals = clampDecimals(currencies[i].Decimals, currencies[i].Code)
		}

		return currencies, nil
	}
}

func CollectDefaults() CollectorFunc {
	return CollectJSON(bytes.NewReader(defaults))
}

func CollectionCurrencies(collectors ...CollectorFunc) ([]Currency, error) {
	out := make([]Currency, 0, len(collectors))
	for i := range collectors {
		c, err := collectors[i]()
		if err != nil {
			return nil, err
		}

		out = append(out, c...)
	}

	return out, nil
}

type Currency struct {
	Name     string `json:"name"`
	Code     string `json:"code"`
	Local    string `json:"local"`
	Symbol   string `json:"symbol"`
	Decimals int    `json:"decimals"`
}

type CurrencyRegistry struct {
	mu       sync.RWMutex
	registry map[string]Currency
}

func NewCurrencyService(currencies []Currency) *CurrencyRegistry {
	registry := make(map[string]Currency, len(currencies))
	for i := range currencies {
		// Clamp decimals to safe range before adding to registry
		currency := currencies[i]
		currency.Decimals = clampDecimals(currency.Decimals, currency.Code)
		registry[currency.Code] = currency
	}

	return &CurrencyRegistry{
		registry: registry,
	}
}

func (cs *CurrencyRegistry) Slice() []Currency {
	cs.mu.RLock()
	defer cs.mu.RUnlock()

	out := make([]Currency, 0, len(cs.registry))
	for key := range cs.registry {
		out = append(out, cs.registry[key])
	}

	slices.SortFunc(out, func(a, b Currency) int {
		if a.Name < b.Name {
			return -1
		}

		if a.Name > b.Name {
			return 1
		}

		return 0
	})

	return out
}

func (cs *CurrencyRegistry) IsSupported(code string) bool {
	upper := strings.ToUpper(code)

	cs.mu.RLock()
	defer cs.mu.RUnlock()
	_, ok := cs.registry[upper]
	return ok
}