import { Dataset } from "@dclimate/jaxray";
import { GeoTemporalDataset } from "./geotemporal-dataset.js";
import { ClientOptions, DatasetMetadata, DatasetRequest, DatasetVersionRequest, DatasetVersionsRequest, GeoSelectionOptions, LoadDatasetOptions } from "./types.js";
import { DatasetCatalog } from "./stac/stac-catalog.js";
import { SirenClient } from "./siren/siren-client.js";
import { EntitiesClient } from "./entities/entities-client.js";
import type { DatasetVersion, DatasetVersionListing } from "./versions/types.js";
export declare class DClimateClient {
    private gatewayUrl;
    private stacServerUrl;
    private rootCid?;
    private cachedGateway?;
    private cachedIpfs?;
    private clientIpfsElements?;
    private stacCatalog?;
    private stacCatalogTimestamp?;
    private stacCacheTtl;
    private sirenClient?;
    private entitiesClient?;
    constructor(options?: ClientOptions);
    private getStacCatalog;
    listAvailableDatasets(): Promise<DatasetCatalog>;
    listCatalogEntries(): Promise<DatasetCatalog>;
    private resolveDatasetDetails;
    listDatasetVersions({ collection, dataset, variant, organization, filters, }: DatasetVersionsRequest): Promise<DatasetVersionListing>;
    getDatasetVersion({ collection, dataset, commitId, variant, organization, }: DatasetVersionRequest): Promise<DatasetVersion>;
    /**
     * Access the Siren REST API client (metric data, regions, metrics).
     * Namespaced so Siren stays separate from the core dataset API:
     *   `client.siren.getMetricData(...)`, `client.siren.listRegions()`, etc.
     * Requires `siren` to be configured in ClientOptions; throws otherwise.
     */
    get siren(): SirenClient;
    /**
     * Access entity (point-observation) datasets -- weather stations, buoys:
     *   `client.entities.load({ cid })`
     *
     * Unlike `client.siren`, this needs no configuration -- it reads over the
     * client's own IPFS gateway -- so it is constructed on first use rather than
     * requiring an option and throwing when absent.
     */
    get entities(): EntitiesClient;
    loadDataset({ request, options, }: {
        request: DatasetRequest;
        options?: LoadDatasetOptions;
    }): Promise<[GeoTemporalDataset, DatasetMetadata] | [Dataset, DatasetMetadata]>;
    selectDataset({ request, selection, options, }: {
        request: DatasetRequest;
        selection: GeoSelectionOptions;
        options?: LoadDatasetOptions;
    }): Promise<[GeoTemporalDataset, DatasetMetadata] | [Dataset, DatasetMetadata]>;
    private loadAndConcatenateVariants;
    private resolveIpfsElements;
}
//# sourceMappingURL=client.d.ts.map