billing

type CompactOptions struct {
	IncludeZero  bool     // include meters with quantity == 0 (default false)
	GroupBy      string   // "" | "meter" | "datacenter" — utilization only
	DatacenterID *string  // scope to a single datacenter (utilization + list_billing_usage)
	MeterTypes   []string // filter by meter type (utilization only)
	Regions      []string // filter by region (utilization only)
	TopN         *int32   // when set, return a flat top-N list across datacenters instead of nested data (utilization only)
}

type CompactUsageDC struct {
	ID       string              `json:"id,omitempty"`
	Name     string              `json:"name,omitempty"`
	Location string              `json:"location,omitempty"`
	Meters   []CompactUsageMeter `json:"meters"`
}

type CompactUsageMeter struct {
	MeterID  string `json:"meter_id,omitempty"`
	Quantity string `json:"quantity,omitempty"` // string per SDK — preserves precision
	Unit     string `json:"unit,omitempty"`
}

type CompactUsageResponse struct {
	StartDate        string            `json:"start_date,omitempty"`
	EndDate          string            `json:"end_date,omitempty"`
	ContractID       string            `json:"contract_id,omitempty"`
	MeterDefinitions map[string]string `json:"meter_definitions,omitempty"`
	Datacenters      []CompactUsageDC  `json:"datacenters,omitempty"`
}

type CompactUtilDC struct {
	ID     string             `json:"id,omitempty"`
	Name   string             `json:"name,omitempty"`
	Meters []CompactUtilMeter `json:"meters"`
}

type CompactUtilMeter struct {
	MeterID    string  `json:"meter_id,omitempty"`
	Type       string  `json:"type,omitempty"`
	Region     string  `json:"region,omitempty"`
	ResourceID string  `json:"resource_id,omitempty"`
	ServerID   string  `json:"server_id,omitempty"`
	Name       string  `json:"name,omitempty"`
	Quantity   float64 `json:"quantity"`
	Unit       string  `json:"unit,omitempty"`
}

type CompactUtilMeterWithDC struct {
	DCID   string `json:"dc_id,omitempty"`
	DCName string `json:"dc_name,omitempty"`
	CompactUtilMeter
}

type CompactUtilizationResponse struct {
	StartDate        string                   `json:"start_date,omitempty"`
	EndDate          string                   `json:"end_date,omitempty"`
	ContractID       string                   `json:"contract_id,omitempty"`
	MeterDefinitions map[string]string        `json:"meter_definitions,omitempty"`
	Datacenters      []CompactUtilDC          `json:"datacenters,omitempty"`
	TopMeters        []CompactUtilMeterWithDC `json:"top_meters,omitempty"`
}