/**
 * Indicators Resource
 *
 * Access derived market indicators and signals: fuel-switching economics,
 * price context, storage analytics, market annotations, CFTC positioning, and
 * congressional energy-sector trades.
 */
import type { OilPriceAPI } from "../client.js";
/**
 * Supported indicator types.
 */
export type IndicatorType = "fuel-switching" | "price-context" | "storage-analytics" | "annotations" | "cftc-positioning" | "congressional-trades";
/**
 * Fuel-switching economics indicator.
 */
export interface FuelSwitchingIndicator {
    /** Switching ratio or breakeven value */
    value: number;
    /** Whether switching is economical */
    economical?: boolean;
    /** From fuel (e.g., "gas") */
    from_fuel?: string;
    /** To fuel (e.g., "oil") */
    to_fuel?: string;
    /** Unit */
    unit?: string;
    /** ISO timestamp */
    timestamp: string;
    /** Additional metadata */
    metadata?: Record<string, unknown>;
}
/**
 * Price-context indicator (where the current price sits historically).
 */
export interface PriceContextIndicator {
    /** Commodity code */
    commodity?: string;
    /** Current price */
    price: number;
    /** Percentile vs trailing window */
    percentile?: number;
    /** 52-week high */
    high_52w?: number;
    /** 52-week low */
    low_52w?: number;
    /** ISO timestamp */
    timestamp: string;
    /** Additional metadata */
    metadata?: Record<string, unknown>;
}
/**
 * Storage-analytics indicator.
 */
export interface StorageAnalyticsIndicator {
    /** Storage level */
    level: number;
    /** Capacity utilization percentage */
    capacity_percent?: number;
    /** Days of cover */
    days_of_cover?: number;
    /** Z-score vs 5-year average */
    zscore?: number;
    /** Unit */
    unit?: string;
    /** ISO timestamp */
    timestamp: string;
    /** Additional metadata */
    metadata?: Record<string, unknown>;
}
/**
 * Market annotation (notable event marker).
 */
export interface AnnotationIndicator {
    /** Annotation ID */
    id?: string;
    /** Title */
    title: string;
    /** Description */
    description?: string;
    /** Category (e.g., "geopolitical", "supply", "demand") */
    category?: string;
    /** Event date */
    date: string;
    /** Related commodity */
    commodity?: string;
    /** Additional metadata */
    metadata?: Record<string, unknown>;
}
/**
 * CFTC positioning indicator (Commitment of Traders).
 */
export interface CFTCPositioningIndicator {
    /** Market / commodity */
    market?: string;
    /** Managed-money long contracts */
    managed_money_long?: number;
    /** Managed-money short contracts */
    managed_money_short?: number;
    /** Net positioning */
    net_position?: number;
    /** Report date */
    report_date: string;
    /** Additional metadata */
    metadata?: Record<string, unknown>;
}
/**
 * Congressional trade indicator (energy-sector disclosures).
 */
export interface CongressionalTradeIndicator {
    /** Representative or senator name */
    member?: string;
    /** Ticker traded */
    ticker?: string;
    /** Transaction type ("buy" / "sell") */
    transaction_type?: string;
    /** Amount range */
    amount_range?: string;
    /** Transaction date */
    transaction_date: string;
    /** Disclosure date */
    disclosure_date?: string;
    /** Additional metadata */
    metadata?: Record<string, unknown>;
}
/**
 * Indicators Resource
 *
 * @example
 * ```typescript
 * import { OilPriceAPI } from 'oilpriceapi';
 *
 * const client = new OilPriceAPI({ apiKey: 'your_key' });
 *
 * // Fuel-switching economics
 * const fs = await client.indicators.fuelSwitching();
 * console.log(`Switching economical: ${fs.economical}`);
 *
 * // CFTC positioning
 * const cftc = await client.indicators.cftcPositioning();
 * cftc.forEach(p => console.log(`${p.market}: net ${p.net_position}`));
 *
 * // Congressional trades
 * const trades = await client.indicators.congressionalTrades();
 * ```
 */
export declare class IndicatorsResource {
    private client;
    constructor(client: OilPriceAPI);
    /**
     * Get an arbitrary indicator by type.
     *
     * @typeParam T - Expected response type.
     * @param type - Indicator type slug.
     * @returns The indicator data.
     * @throws {ValidationError} If the type is invalid.
     */
    get<T = unknown>(type: IndicatorType): Promise<T>;
    /** Fuel-switching economics indicator. */
    fuelSwitching(): Promise<FuelSwitchingIndicator>;
    /** Price-context indicator. */
    priceContext(): Promise<PriceContextIndicator>;
    /** Storage-analytics indicator. */
    storageAnalytics(): Promise<StorageAnalyticsIndicator>;
    /** Market annotations. */
    annotations(): Promise<AnnotationIndicator[]>;
    /** CFTC positioning (Commitment of Traders) indicators. */
    cftcPositioning(): Promise<CFTCPositioningIndicator[]>;
    /** Congressional energy-sector trade indicators. */
    congressionalTrades(): Promise<CongressionalTradeIndicator[]>;
}