import { PolarisQuery } from '../../generic';
import { LabelFilter } from './label-filter';
import { TimeSeries } from './time-series';
import { ValueFilter } from './value-filter';
/**
 * Defines the type of the results of a `TimeSeriesQuery`.
 */
export declare enum TimeSeriesQueryResultType {
    /** The query will result in a set of `TimeSeriesInstant` instances. */
    Instant = 0,
    /** The query will result in a set of `TimeSeries` instances. */
    Range = 1
}
/**
 * @returns `true` if `obj` is a `TimeSeriesQuery`, otherwise `false`.
 */
export declare function isTimeSeriesQuery(obj: any | TimeSeriesQuery<any>): obj is TimeSeriesQuery<any>;
/**
 * A query that results in `TimeSeries` and which provides operations that are
 * applicable to all `TimeSeries` queries.
 *
 * There are two main types of TimeSeriesQueries:
 * - `TimeRangeQuery`, whose execution results in an array of `TimeSeries`, each normally containing multiple samples.
 * - `TimeInstantQuery`, whose execution results in an array of `TimeSeriesInstant` objects, each containing a single sample.
 *
 * Both main query types allow applying filters on the values of the `TimeSeries`.
 *
 * The main query types may be combined with `LabelFilterableQuery`, which allows filtering on labels.
 * A query resulting from a `TimeSeriesSource.select()` will be either
 * - a `LabelFilterableTimeRangeQuery = TimeRangeQuery & LabelFilterableQuery`, if a `TimeRange` was specified, or
 * - a `LabelFilterableTimeInstantQueryQuery = TimeInstantQuery & LabelFilterableQuery`, if no `TimeRange` was specified.
 *
 * The use of one of any method other than `filterOnLabel()`, will usually
 * result in the loss of the label-filterable functionality for the rest of the query, because
 * some DBs only support label filtering on the stored data, but not on computed data.
 *
 * A `TimeSeriesQuery` realization is immutable to allow query objects to be reused in multiple places.
 *
 * @param T The type of `TimeSeries` that is returned by this query.
 */
export interface TimeSeriesQuery<T extends TimeSeries<any>> extends PolarisQuery<T> {
    /** Defines the type of the results of this `TimeSeriesQuery` */
    readonly resultType: TimeSeriesQueryResultType;
}
/**
 * A `TimeSeriesQuery` that allows filtering on the values.
 *
 * A `TimeSeriesQuery` realization is immutable to allow query objects to be reused in multiple places.
 *
 * @param T The type of `TimeSeries` that is returned by this query.
 * @param Q Used to capture the type of `this` for every interface realization, because the filter() method must return
 * a new instance of the realizing class and TypeScript's polymorphic `this` return type does not allow capturing this so far
 * (see https://github.com/Microsoft/TypeScript/issues/283#issuecomment-194034654).
 *
 * @note An alternative to the `Q` class parameter would have been a generic parameter on every method:
 * `filterOnValue<Q extends this>(predicate: ValueFilter): Q;`
 * But this would have allowed the user to (incorrectly) change the typing of the return value of a method:
 * `query.filterOnValue<SomeOtherQueryType>()`.
 */
export interface ValueFilterableQuery<T extends TimeSeries<any>, Q extends ValueFilterableQuery<T, any>> extends TimeSeriesQuery<T> {
    /**
     * Filters the input `TimeSeries`, based on their values using the provided `predicate`, i.e., only
     * `TimeSeries` that fulfill the `predicate` constitute the output of the filter operation.
     *
     * Chaining multiple `filterOnLabel()` calls will result in a combination of these filters using
     * the `AND` operator, i.e., all the predicates must be fulfilled.
     *
     * @param predicate The value predicate that all output `TimeSeries` must fulfill.
     * @returns A new `TimeSeriesQuery`, whose results are all the input `TimeSeries` that fulfill the `predicate`.
     */
    filterOnValue(predicate: ValueFilter): Q;
}
/**
 * A `TimeSeriesQuery` that allows filtering on the labels.
 *
 * A `TimeSeriesQuery` realization is immutable to allow query objects to be reused in multiple places.
 *
 * @param T The type of `TimeSeries` that is returned by this query.
 * @param Q Used to capture the type of `this` for every interface realization, because the filter() method must return
 * a new instance of the realizing class and TypeScript's polymorphic `this` return type does not allow capturing this so far
 * (see https://github.com/Microsoft/TypeScript/issues/283#issuecomment-194034654).
 *
 * @note An alternative to the `Q` class parameter would have been a generic parameter on every method:
 * `filterOnLabel<Q extends this>(predicate: LabelFilter): Q;`
 * But this would have allowed the user to (incorrectly) change the typing of the return value of a method:
 * `query.filterOnLabel<SomeOtherQueryType>()`.
 */
export interface LabelFilterableQuery<T extends TimeSeries<any>, Q extends LabelFilterableQuery<T, any>> extends TimeSeriesQuery<T> {
    /**
     * Filters the input `TimeSeries`, based on their labels using the provided `predicate`, i.e., only
     * `TimeSeries` that fulfill the `predicate` constitute the output of the filter operation.
     *
     * Chaining multiple `filterOnLabel()` calls will result in a combination of these filters using
     * the `AND` operator, i.e., all the predicates must be fulfilled.
     *
     * @param predicate The label predicate that all output `TimeSeries` must fulfill.
     * @returns A new `TimeSeriesQuery`, whose results are all the input `TimeSeries` that fulfill the `predicate`.
     */
    filterOnLabel(predicate: LabelFilter): Q;
}