import { QelosSDKOptions } from '../types';
import BaseSDK from '../base-sdk';
import { IPlan, ISubscription, IInvoice, ICoupon, BillableEntityType, SubscriptionStatus, InvoiceStatus, BillingCycle, IPaymentsConfigurationMetadata } from '@qelos/global-types';
export interface PaymentsConfigurationRecord {
    key: string;
    metadata: IPaymentsConfigurationMetadata;
}
export interface AdminCheckoutRequest {
    planId: string;
    billingCycle: BillingCycle;
    /** When omitted, the authenticated user / default billable entity is used (same as public checkout). */
    billableEntityType?: BillableEntityType;
    billableEntityId?: string;
    couponCode?: string;
    successUrl?: string;
    cancelUrl?: string;
    /** When true, cancels any existing active/trialing subscription before checkout. */
    reset?: boolean;
    /**
     * Admin-only. For plans with `dynamic: true`, sets the `dynamicAmount` on the
     * pending subscription before initiating checkout. Regular users cannot set this;
     * use `setSubscriptionDynamicAmount()` + a separate `checkout()` call instead.
     */
    amount?: number;
}
export interface CreateSubscriptionData {
    planId: string;
    billingCycle: BillingCycle;
    billableEntityType: BillableEntityType;
    billableEntityId: string;
    /** Required for plans with `dynamic: true` before checkout can be initiated. */
    dynamicAmount?: number;
    couponCode?: string;
}
export interface AdminCheckoutResponse {
    subscriptionId: string;
    checkoutUrl?: string;
    clientToken?: string;
}
export default class QlPaymentsAdmin extends BaseSDK {
    private options;
    constructor(options: QelosSDKOptions);
    getPlans(query?: {
        isActive?: boolean;
    }): Promise<IPlan[]>;
    getPlan(planId: string): Promise<IPlan>;
    createPlan(data: Omit<IPlan, '_id' | 'tenant' | 'created'>): Promise<IPlan>;
    updatePlan(planId: string, data: Partial<IPlan>): Promise<IPlan>;
    deletePlan(planId: string): Promise<IPlan>;
    /**
     * Start subscription checkout (same as `sdk.payments.checkout`, plus optional billable-entity overrides for admins).
     * For plans with `dynamic: true`, `amount` is required.
     */
    checkout(params: AdminCheckoutRequest): Promise<AdminCheckoutResponse>;
    getSubscriptions(query?: {
        billableEntityType?: BillableEntityType;
        billableEntityId?: string;
        status?: SubscriptionStatus;
    }): Promise<ISubscription[]>;
    getSubscription(subscriptionId: string): Promise<ISubscription>;
    /**
     * Creates a pending subscription on behalf of any billable entity. Admins can
     * also set `dynamicAmount` here for dynamic plans, making the subscription
     * immediately ready for checkout.
     */
    createSubscription(data: CreateSubscriptionData): Promise<ISubscription>;
    cancelSubscription(subscriptionId: string): Promise<ISubscription>;
    /**
     * Sets or updates the dynamic amount for a pending subscription. Only admins
     * can call this. Must be done before a user can complete checkout on a dynamic plan.
     */
    setSubscriptionDynamicAmount(subscriptionId: string, amount: number): Promise<ISubscription>;
    getInvoices(query?: {
        billableEntityType?: BillableEntityType;
        billableEntityId?: string;
        status?: InvoiceStatus;
    }): Promise<IInvoice[]>;
    getInvoice(invoiceId: string): Promise<IInvoice>;
    getCoupons(query?: {
        isActive?: boolean;
    }): Promise<ICoupon[]>;
    getCoupon(couponId: string): Promise<ICoupon>;
    createCoupon(data: Omit<ICoupon, '_id' | 'tenant' | 'created' | 'currentRedemptions'>): Promise<ICoupon>;
    updateCoupon(couponId: string, data: Partial<ICoupon>): Promise<ICoupon>;
    deleteCoupon(couponId: string): Promise<ICoupon>;
    /** Load tenant payments settings (`payments-configuration`). */
    getPaymentsConfiguration(): Promise<PaymentsConfigurationRecord>;
    /** Update tenant payments settings. Partial metadata is merged with the existing record. */
    updatePaymentsConfiguration(metadata: Partial<IPaymentsConfigurationMetadata>): Promise<PaymentsConfigurationRecord>;
}