import { CatalogResponse, DatasetMetadata, ODSQueryParams, ODSResponse, RecordObject } from './types.js';
/**
 * HTTP client for OpenDataSoft API (data.gouv.nc)
 * No authentication required - completely free API
 */
export declare class NewCaledoniaClient {
    private readonly baseUrl;
    private readonly timeout;
    private readonly maxRetries;
    private readonly metadataCache;
    /**
     * Fetch records from a dataset
     */
    getRecords<T extends RecordObject = RecordObject>(datasetId: string, params?: ODSQueryParams): Promise<ODSResponse<T>>;
    /**
     * Fetch aggregated data from a dataset
     */
    getAggregates<T extends RecordObject = RecordObject>(datasetId: string, select: string, options?: {
        where?: string;
        groupBy?: string;
        orderBy?: string;
        limit?: number;
    }): Promise<ODSResponse<T>>;
    /**
     * Search across all datasets
     */
    searchDatasets(query: string): Promise<CatalogResponse>;
    /**
     * Fetch dataset metadata from the catalog
     */
    getDatasetMetadata(datasetId: string): Promise<DatasetMetadata | undefined>;
    /**
     * Check whether a dataset currently exists in the public catalog
     */
    datasetExists(datasetId: string): Promise<boolean>;
    /**
     * Resolve the first matching field name for a dataset
     */
    resolveField(datasetId: string, candidates: string[]): Promise<string | undefined>;
    /**
     * Build URL with query parameters
     */
    private buildUrl;
    /**
     * Execute HTTP request with retries and timeout handling
     */
    private fetchJson;
    private isRetryableError;
    private delay;
}
export declare const client: NewCaledoniaClient;
//# sourceMappingURL=client.d.ts.map