import Stripe from "stripe";
import { StripeService } from "../../stripe/services/stripe.service";
/**
 * StripeUsageApiService
 *
 * Manages usage-based billing with Stripe's V2 Billing Meters API (Stripe v20+).
 * Allows reporting meter events for usage-based pricing and retrieving usage summaries.
 * Requires billing meters to be configured in the Stripe Dashboard.
 */
export declare class StripeUsageApiService {
    private readonly stripeService;
    constructor(stripeService: StripeService);
    /**
     * Report usage using the V2 Billing Meters API (Stripe v20+)
     */
    reportMeterEvent(params: {
        eventName: string;
        customerId: string;
        value: number;
        timestamp?: number;
        identifier?: string;
    }): Promise<Stripe.V2.Billing.MeterEvent>;
    /**
     * List meter event summaries for a customer
     */
    getMeterEventSummaries(params: {
        meterId: string;
        customerId: string;
        startTime: number;
        endTime: number;
    }): Promise<Stripe.Billing.MeterEventSummary[]>;
    /**
     * List all billing meters configured in Stripe
     */
    listMeters(): Promise<Stripe.Billing.Meter[]>;
    /**
     * Get a subscription item configured for metered billing
     */
    getSubscriptionItemForMeteredBilling(subscriptionId: string): Promise<Stripe.SubscriptionItem | null>;
}
//# sourceMappingURL=stripe-usage-api.service.d.ts.map