vantageapi

type APIError struct {
	StatusCode int
	RetryAfter time.Duration
	// contains filtered or unexported fields
}

type Client interface {
	GetCosts(ctx context.Context, params *GetCostsParams) (*CostsResponse, error)
}

type CostAmount struct {
	Amount   string // Decimal string
	Currency string // ISO 4217 code
}

type CostRow struct {
	AccruedAt        string      // ISO 8601: YYYY-MM-DDTHH:MM:SSZ or YYYY-MM-DD
	Amount           string      // Decimal string, never float
	Currency         string      // ISO 4217 code (USD, EUR, etc.)
	Usage            interface{} // Untyped, provider-specific
	UsageUnit        *string
	Provider         *string
	Service          *string
	AccountID        *string
	BillingAccountID *string
	Region           *string
	ResourceID       *string
	ResourceName     *string
	Tags             []string // Array of strings, format undocumented
	CostCategory     *string
	CostSubcategory  *string
	ChargeType       *string // Distinguishes tax, credit, refund lines
	Tagged           *bool
	Segment          *string
}

type CostSettings struct {
	Amortize           *bool
	IncludeCredits     *bool
	IncludeRefunds     *bool
	IncludeDiscounts   *bool
	IncludeTax         *bool
	AggregateBy        *string
	ShowPreviousPeriod *bool
	UnAllocated        *bool
}

type CostsResponse struct {
	// Costs is the list of cost rows; amounts are decimal strings
	Costs []*CostRow
	// TotalCost is the sum of all costs in the period
	TotalCost *CostAmount
	// TotalUsage is usage broken down by unit
	TotalUsage []*UsageAmount
	// Links for pagination (next URL, etc.)
	Links *PaginationLinks
}

type GetCostsParams struct {
	CostReportToken *string
	WorkspaceToken  *string
	Filter          *string
	StartDate       *string  // ISO 8601 format: YYYY-MM-DD
	EndDate         *string  // ISO 8601 format: YYYY-MM-DD
	DateBin         *string  // day, week, month, quarter, hour
	Groupings       []string // e.g., []string{"provider", "service", "account_id"}
	Page            *int32
	Limit           *int32
	// Settings for cost basis
	Settings *CostSettings
}

type PaginationLinks struct {
	Self  *string
	First *string
	Next  *string
	Prev  *string
	Last  *string
}

type UsageAmount struct {
	Amount string // Decimal string
	Unit   string
}