import type { IPFSELEMENTS_INTERFACE } from "@dclimate/jaxray";
import type { SirenOptions } from "./siren/types.js";
import type { VersionFilters } from "./versions/types.js";
export type IpfsElements = IPFSELEMENTS_INTERFACE;
export type ShardReadMode = "full" | "sparse";
export interface ClientOptions {
    gatewayUrl?: string;
    /**
     * Pin catalog resolution to a specific root CID. Also disables the STAC
     * server fast path, which only serves the latest catalog version.
     */
    rootCid?: string;
    ipfsElements?: IpfsElements;
    /**
     * STAC server URL for fast CID resolution.
     * If provided, the client will try this server first before falling back to IPFS catalog.
     * Default: "http://localhost:8081"
     */
    stacServerUrl?: string | null;
    /**
     * Siren REST API configuration.
     * Enables getMetricData() and listRegions() methods on the client.
     * Uses API key auth (Bearer token).
     */
    siren?: SirenOptions;
}
export interface LoadDatasetOptions {
    gatewayUrl?: string;
    ipfsElements?: IpfsElements;
    returnJaxrayDataset?: boolean;
    autoConcatenate?: boolean;
    zarrGroup?: string;
    /** Read only the requested shard entry on read-only sparse-store cache misses. */
    shardReadMode?: ShardReadMode;
}
export interface PointQueryOptions {
    method?: "nearest" | "exact";
    latitudeKey?: string;
    longitudeKey?: string;
    tolerance?: number;
}
export interface BoundsSelectionOptions {
    latitudeKey?: string;
    longitudeKey?: string;
}
export interface TimeRange {
    start: number | Date | string;
    end: number | Date | string;
}
export type BoundsSelection = readonly [west: number, south: number, east: number, north: number] | {
    west: number;
    south: number;
    east: number;
    north: number;
    options?: BoundsSelectionOptions;
};
export interface GeoSelectionOptions {
    point?: {
        latitude: number;
        longitude: number;
        options?: PointQueryOptions;
    };
    bounds?: BoundsSelection;
    boundsOptions?: BoundsSelectionOptions;
    timeRange?: TimeRange;
}
export interface DatasetMetadata {
    dataset: string;
    collection?: string;
    variant?: string;
    organization?: string;
    /**
     * Array of variants that were concatenated together (if STAC-based concatenation was used)
     */
    concatenatedVariants?: string[];
    /**
     * Dimension used for concatenation (e.g., "time")
     */
    concatDimension?: string;
    resolution?: string;
    zarrGroup?: string;
    path: string;
    cid: string;
    /**
     * Source type: "stac" for STAC resolution, "stac_concatenated" for STAC-based concatenation, or "direct_cid" for direct CID loading
     */
    source: "stac" | "stac_concatenated" | "direct_cid";
    fetchedAt: Date;
    versionsApi?: string;
    provenanceApi?: string;
    citationApi?: string;
    streamId?: string;
    commitId?: string;
    versionLabel?: string;
    isCitable?: boolean;
    retentionClass?: string;
}
export interface DatasetRequest {
    dataset?: string;
    collection?: string;
    variant?: string;
    organization?: string;
    cid?: string;
    resolution?: string;
}
export interface DatasetVersionsRequest {
    collection: string;
    dataset: string;
    variant?: string;
    organization?: string;
    filters?: VersionFilters;
}
export interface DatasetVersionRequest {
    collection: string;
    dataset: string;
    commitId: string;
    variant?: string;
    organization?: string;
}
export interface DataArrayObject {
    data: unknown;
    dims: string[];
    coords: Record<string, unknown[]>;
    attrs: Record<string, unknown>;
    name?: string;
    shape: number[];
}
export interface DatasetObject {
    dataVars: Record<string, DataArrayObject>;
    coords: Record<string, unknown[]>;
    attrs: Record<string, unknown>;
    dims: string[];
    sizes: Record<string, number>;
}
//# sourceMappingURL=types.d.ts.map