Interface CanonicalQuery

Serializable form of the current canonical Query. AbortSignal is deliberately excluded: cancellation belongs to execution, never identity.

interface CanonicalQuery {
    aggregation?: AggregationSpec;
    filter?: QueryFilterExpression;
    orderBy?: readonly {
        direction: "asc" | "desc";
        field: string;
    }[];
    outFields?: readonly string[];
    outSr?: string | number;
    pagination?: {
        limit?: number;
        offset?: number;
    };
    returnGeometry?: boolean;
    spatialFilter?: CanonicalSpatialFilter;
    temporalFilter?: QueryTemporalFilter;
    where?: {
        expression: string;
        kind: "source-native";
    };
}

Properties

aggregation? filter? orderBy? outFields? outSr? pagination? returnGeometry? spatialFilter? temporalFilter? where?

Properties

Optional Readonlyaggregation

aggregation?: AggregationSpec

Optional Readonlyfilter

filter?: QueryFilterExpression

Typed semantic filter carried verbatim into the IR so it participates in hashQueryIr / hashQueryPlan exactly as every other query member does. A compiler that cannot express it refuses; it is never dropped in planning.

Optional ReadonlyorderBy

orderBy?: readonly {
    direction: "asc" | "desc";
    field: string;
}[]

Optional ReadonlyoutFields

outFields?: readonly string[]

Optional ReadonlyoutSr

outSr?: string | number

Optional Readonlypagination

pagination?: {
    limit?: number;
    offset?: number;
}

Optional ReadonlyreturnGeometry

returnGeometry?: boolean

Optional ReadonlyspatialFilter

spatialFilter?: CanonicalSpatialFilter

Optional ReadonlytemporalFilter

temporalFilter?: QueryTemporalFilter

Canonical temporal constraint (instant or interval, optionally field bound).

Optional Readonlywhere

where?: {
    expression: string;
    kind: "source-native";
}

The current contract carries a source-native string escape hatch.

Settings

Member Visibility

On This Page

Properties