currencyx

type AmountAllocation[T any] struct {
	Key    T
	Amount alpacadecimal.Decimal
}

type AmountAllocationInput[T any] struct {
	Amount alpacadecimal.Decimal
	Items  []AmountAllocationItem[T]

	// CompareKey is used as a deterministic tie-breaker when two buckets have
	// the same fractional remainder. If nil, the original item order is used.
	CompareKey func(left, right T) int
}

type AmountAllocationItem[T any] struct {
	Key    T
	Amount alpacadecimal.Decimal
}

type Code currency.Code

type CostBasis struct {
	// FiatCode is the target fiat currency code (e.g. USD, EUR) that the rate converts to.
	FiatCode Code `json:"fiat_code"`
	// Rate is the exchange rate: one unit of the custom currency equals this many units of FiatCode.
	Rate alpacadecimal.Decimal `json:"rate"`
	// EffectiveFrom is the start of the period during which this rate applies (inclusive).
	EffectiveFrom time.Time `json:"effective_from"`
	// EffectiveTo is the end of the period during which this rate applies (exclusive).
	// Nil means the rate is open-ended and currently active.
	EffectiveTo *time.Time `json:"effective_to,omitempty"`
}

type Currency interface {
	models.Validator
	CurrencyCalculator
	CurrencyFormatter

	Type() CurrencyType
	Details() CurrencyDetails

	AsFiat() (*FiatCurrency, error)
	AsCustom() (*CustomCurrency, error)

	Definition() *currency.Def
}

type CurrencyBuilder struct {
	// contains filtered or unexported fields
}

type CurrencyCalculator interface {
	RoundToPrecision(amount alpacadecimal.Decimal) alpacadecimal.Decimal
	IsRoundedToPrecision(amount alpacadecimal.Decimal) bool

	RoundUp(amount alpacadecimal.Decimal) alpacadecimal.Decimal
	RoundDown(amount alpacadecimal.Decimal) alpacadecimal.Decimal

	Unit() alpacadecimal.Decimal
}

type CurrencyDetails struct {
	Code               Code   `json:"code"`
	Name               string `json:"name"`
	Symbol             string `json:"symbol,omitempty"`
	Precision          uint32 `json:"precision"`
	DecimalMark        string `json:"decimal_mark,omitempty"`
	ThousandsSeparator string `json:"thousands_separator,omitempty"`
}

type CurrencyFormatter interface {
	FormatAmount(amount alpacadecimal.Decimal) string
}

type CurrencyType string

type CustomCurrency struct {
	// contains filtered or unexported fields
}

type FiatCode currency.Code

type FiatCurrency struct {
	// contains filtered or unexported fields
}

type WeightedAllocation[T any] struct {
	Key    T
	Amount alpacadecimal.Decimal
}

type WeightedAllocationInput[T any] struct {
	Amount alpacadecimal.Decimal
	Items  []WeightedAllocationItem[T]

	// CompareKey is used as a deterministic tie-breaker when two items have
	// the same fractional remainder. If nil, the original item order is used.
	CompareKey func(left, right T) int
}

type WeightedAllocationItem[T any] struct {
	Key    T
	Weight alpacadecimal.Decimal
}