import type { SubscriptionSummaryLite } from './subscriptions.js';
export type BenefitType = 'reservation' | 'savings-plan';
export type BenefitScope = 'Shared' | 'Single' | 'ManagementGroup' | 'Unknown';
export type BenefitBucket = 'expired' | 'expiring-30d' | 'expiring-60d' | 'expiring-180d' | 'active-gt-180d' | 'underutilized-30d';
export type BenefitCostBasis = 'actual' | 'amortized';
export type OdeSource = 'pricing_model' | 'retail_rate' | 'discount_delta' | 'unknown';
export type EsrStatus = 'computed' | 'estimated' | 'unavailable';
export interface IBenefitUtilization {
    trend?: string;
    oneDay?: number;
    sevenDay?: number;
    thirtyDay?: number;
    source?: 'aggregate' | 'usage' | 'reservation-summary';
}
export type BenefitUtilizationAggregateUnit = 'hours' | 'quantity' | 'currency';
/**
 * Lossless utilization numerator and denominator for weighted aggregation.
 * `used` and `reserved` use the same unit. Keep separate entries when unit or
 * currency differs, then aggregate only compatible entries.
 */
export interface IBenefitWeightedUtilizationAggregateBase {
    used: number;
    reserved: number;
    /** Derived percentage on a 0-100 scale. */
    percentage?: number;
    sampleCount?: number;
}
export type IBenefitWeightedUtilizationAggregate = IBenefitWeightedUtilizationAggregateBase & ({
    unit: Exclude<BenefitUtilizationAggregateUnit, 'currency'>;
    currency?: never;
} | {
    unit: 'currency';
    currency: string;
});
export interface IBenefit {
    id: string;
    benefitType: BenefitType;
    scope: BenefitScope;
    type: string;
    displayName?: string;
    expiryDate?: string | null;
    status: 'active' | 'expired';
    subscriptionId?: string;
    purchaseDate?: string | null;
    reservedQuantity?: number;
    commitmentAmount?: number;
    commitmentCurrencyCode?: string;
    commitmentGrain?: string;
    commitmentUnit?: string;
    skuName?: string;
    skuDescription?: string;
    location?: string;
    term?: string;
    billingPlan?: string;
    billingScopeId?: string;
    appliedScopeDisplayName?: string;
    provisioningState?: string;
    renew?: boolean;
    purchasedQuantity?: number;
    usedQuantity?: number;
    remainingQuantity?: number;
    totalReservedQuantity?: number;
    reservedHours?: number;
    usedHours?: number;
    utilization?: IBenefitUtilization;
}
export interface IBenefitBucketSummary {
    bucket: BenefitBucket;
    total: number;
    byType: Array<{
        type: string;
        count: number;
    }>;
    byScope: Array<{
        scope: BenefitScope;
        count: number;
    }>;
    byBenefitType: Array<{
        benefitType: BenefitType;
        count: number;
    }>;
}
export interface IBenefitUtilizationSummary {
    total: number;
    withData: number;
    sevenDayAverage?: number;
    thirtyDayAverage?: number;
    sevenDayAggregates?: IBenefitWeightedUtilizationAggregate[];
    thirtyDayAggregates?: IBenefitWeightedUtilizationAggregate[];
    byBenefitType: Array<{
        benefitType: BenefitType;
        total: number;
        withData: number;
        sevenDayAverage?: number;
        thirtyDayAverage?: number;
        sevenDayAggregates?: IBenefitWeightedUtilizationAggregate[];
        thirtyDayAggregates?: IBenefitWeightedUtilizationAggregate[];
    }>;
}
export interface IBenefitInventorySummary {
    generatedAt: string;
    summary: {
        total: number;
        active: number;
        expired: number;
    };
    buckets: IBenefitBucketSummary[];
    utilization: IBenefitUtilizationSummary;
}
export interface IBenefitCoverageServiceEntry {
    serviceName: string;
    eligibleQuantity?: number;
    coveredQuantity?: number;
    eligibleCost?: number;
    coveredCost?: number;
    uncoveredCost?: number;
    coveragePercent?: number;
}
export interface IBenefitCoverageServiceSummary {
    basis: BenefitCostBasis;
    windowStart?: string;
    windowEnd?: string;
    eligibleQuantity?: number;
    coveredQuantity?: number;
    eligibleCost?: number;
    coveredCost?: number;
    uncoveredCost?: number;
    coveragePercent?: number;
    services: IBenefitCoverageServiceEntry[];
}
export interface IBenefitCoverageBreakdownEntry {
    benefitId?: string;
    benefitName?: string;
    /** Explicit producer classification. Consumers should only infer from identifiers for legacy artifacts. */
    benefitType?: BenefitType;
    coveredQuantity?: number;
    coveredCost?: number;
}
export interface IEffectiveSavingsRateSummary {
    basis: BenefitCostBasis;
    windowStart?: string;
    windowEnd?: string;
    odeCost?: number;
    actualCost?: number;
    amortizedCost?: number;
    esrPercent?: number;
    odeSource?: OdeSource;
    esrStatus?: EsrStatus;
}
export interface ISubscriptionBenefitsSummary {
    version: string;
    generatedAt: string;
    subscription?: SubscriptionSummaryLite;
    inventorySummary: IBenefitInventorySummary;
    inventory: IBenefit[];
    sharedInventorySummary?: IBenefitInventorySummary;
    sharedInventory?: IBenefit[];
    utilization: IBenefitUtilizationSummary;
    coverage: IBenefitCoverageServiceSummary[];
    esr: IEffectiveSavingsRateSummary[];
    warnings?: string[];
}
//# sourceMappingURL=benefits.d.ts.map