@honua/app-platform 0.1.2-beta.0 → 0.1.7-beta.0

package/contract/protocol-module.d.ts

@@ -9,10 +9,10 @@
  * equivalent minimal
  * seam for a `Source.protocol(...)` escape-hatch adapter: discovery, the
  * capability set it advertises for a descriptor, diagnostics, and
- * disposal. `compile`/`execute` are intentionally absent from this first
- * bounded slice — no first-party module has migrated its query-compiler
- * pipeline onto the seam yet (see `docs/plugin-manifest-certification.md`
- * for the tracked follow-up).
+ * disposal. Query-capable modules implement the atomic
+ * {@link QueryCapableProtocolModule} extension, whose deterministic `compile`
+ * and explicitly-authorized `execute` hooks are always present together.
+ * Tiles-only modules such as PMTiles implement only this base interface.
  *
  * This module has no dependency on `src/plugin` or any global registry: a
  * `ProtocolModule` is a plain value object. SDK-internal `Source`
@@ -24,7 +24,7 @@
  *
  * @module
  */
-import type { Capabilities, SourceDescriptor } from "./types.js";
+import type { Capabilities, Protocol, Result, SourceDescriptor } from "./types.js";
 /** Runtime environments a protocol module can execute in. Mirrors `RendererEnvironment`. */
 export type ProtocolModuleEnvironment = "browser" | "node" | "worker";
 /** Stable, protocol-neutral diagnostic exposed by one discovered module handle. */
@@ -35,6 +35,49 @@ export interface ProtocolModuleDiagnostic {
 }
 export interface ProtocolModuleDiscoverOptions {
     readonly signal?: AbortSignal;
+    /**
+     * Stable structural authorization-scope identifiers bound to this handle.
+     * Tokens and credential values are prohibited; implementations retain only
+     * a secret-free derived identity.
+     */
+    readonly authorizationScope?: readonly string[];
+}
+/** Canonical query-family operations a protocol module may compile and execute. */
+export type ProtocolModuleQueryOperation = "query" | "queryAll" | "queryAggregate";
+/**
+ * Type binding for one module's query seam.
+ *
+ * The compiler source identity is deliberately separate from
+ * {@link SourceDescriptor}: deterministic compilers receive a
+ * credential-free, serializable identity rather than a runtime descriptor
+ * or client. The execution query may carry runtime-only values such as an
+ * `AbortSignal`; those values never enter the compiled artifact.
+ */
+export interface ProtocolModuleQueryBinding {
+    readonly source: unknown;
+    readonly compileQuery: unknown;
+    readonly compiled: unknown;
+    readonly executeQuery: unknown;
+}
+/** Pure input to a protocol module's deterministic compiler. */
+export interface ProtocolModuleQueryCompileInput<TSource = unknown, TQuery = unknown> {
+    readonly source: TSource;
+    readonly query: TQuery;
+    readonly operation: ProtocolModuleQueryOperation;
+}
+/**
+ * Runtime input to a protocol module executor.
+ *
+ * `compiled` is the inspectable, credential-free artifact. Runtime authority
+ * stays on the discovered handle and on dependencies explicitly injected into
+ * the module factory. `signal` is execution state and is never part of the
+ * artifact's deterministic identity.
+ */
+export interface ProtocolModuleQueryExecuteInput<TCompiled = unknown, TQuery = unknown> {
+    readonly compiled: TCompiled;
+    readonly query: TQuery;
+    readonly operation: ProtocolModuleQueryOperation;
+    readonly signal?: AbortSignal;
 }
 /**
  * One discovered, disposable protocol-module handle bound to a source
@@ -42,9 +85,14 @@ export interface ProtocolModuleDiscoverOptions {
  * returned by `Source.protocol(name)` (for example a `HonuaPmtilesArchive`),
  * so migrating a built-in onto this seam never changes what callers observe
  * through the existing escape hatch.
+ *
+ * `TProtocol` mirrors the descriptor kind a `ProtocolModule<TKind>` accepts
+ * (built-in `Protocol` by default, or `TKind | Protocol` when parameterized
+ * by `discover()` below) so a handle for a custom-kind descriptor carries
+ * that kind through rather than widening to `string`.
  */
-export interface ProtocolModuleHandle<TAdapter = unknown> {
-    readonly descriptor: SourceDescriptor;
+export interface ProtocolModuleHandle<TAdapter = unknown, TProtocol extends string = Protocol> {
+    readonly descriptor: SourceDescriptor<TProtocol>;
     readonly capabilities: Capabilities;
     readonly adapter: TAdapter;
     readonly diagnostics: readonly ProtocolModuleDiagnostic[];
@@ -58,13 +106,40 @@ export interface ProtocolModuleHandle<TAdapter = unknown> {
  * (as PMTiles does — the archive itself is opened lazily on first
  * `describe()`), or asynchronously for a module whose discovery is
  * inherently a network round trip.
+ *
+ * `capabilities()`/`discover()` accept `SourceDescriptor<TKind | Protocol>`
+ * — the built-in `Protocol` union plus this module's own `TKind` — so a
+ * third-party module with a custom protocol id (e.g. the cloud-tiles fixture's
+ * `"cloud-tiles"`, `test/fixtures/plugins/cloud-tiles/protocol-module.ts`)
+ * can pass a descriptor typed to its own kind without an `as` cast, matching
+ * how `pmtilesProtocolModule()` (`src/contract/pmtiles.ts`) already accepts
+ * `SourceDescriptor<"pmtiles" | Protocol>`, i.e. `SourceDescriptor` (issue
+ * #671).
  */
 export interface ProtocolModule<TKind extends string = string, TAdapter = unknown> {
     readonly kind: TKind;
     readonly environments: readonly ProtocolModuleEnvironment[];
     readonly peer?: unknown;
     /** Pure and synchronous: never performs I/O. */
-    capabilities(descriptor: SourceDescriptor): Capabilities;
-    discover(descriptor: SourceDescriptor, options?: ProtocolModuleDiscoverOptions): ProtocolModuleHandle<TAdapter> | Promise<ProtocolModuleHandle<TAdapter>>;
+    capabilities(descriptor: SourceDescriptor<TKind | Protocol>): Capabilities;
+    discover(descriptor: SourceDescriptor<TKind | Protocol>, options?: ProtocolModuleDiscoverOptions): ProtocolModuleHandle<TAdapter, TKind | Protocol> | Promise<ProtocolModuleHandle<TAdapter, TKind | Protocol>>;
+}
+/**
+ * Atomic query-capable extension of {@link ProtocolModule}.
+ *
+ * A module either implements this interface and therefore provides both
+ * hooks, or implements the discovery-only base interface and provides
+ * neither. Keeping the pair in a separate required interface prevents
+ * partially executable modules from satisfying the public contract.
+ */
+export interface QueryCapableProtocolModule<TKind extends string = string, TAdapter = unknown, TQueryBinding extends ProtocolModuleQueryBinding = ProtocolModuleQueryBinding> extends ProtocolModule<TKind, TAdapter> {
+    /** Deterministic, synchronous, and I/O-free query compiler. */
+    compile(input: ProtocolModuleQueryCompileInput<TQueryBinding["source"], TQueryBinding["compileQuery"]>): TQueryBinding["compiled"];
+    /**
+     * Explicitly-authorized executor paired with {@link compile}.
+     * Implementations execute only against the supplied discovered handle and
+     * must not consult or mutate an ambient registry.
+     */
+    execute<TRecord = Record<string, unknown>>(handle: ProtocolModuleHandle<TAdapter, TKind | Protocol>, input: ProtocolModuleQueryExecuteInput<TQueryBinding["compiled"], TQueryBinding["executeQuery"]>): Promise<Result<TRecord>>;
 }
 //# sourceMappingURL=protocol-module.d.ts.map

package/contract/protocol-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"protocol-module.d.ts","sourceRoot":"","sources":["../../../src/contract/protocol-module.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,4FAA4F;AAC5F,MAAM,MAAM,yBAAyB,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtE,mFAAmF;AACnF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CAAC,QAAQ,GAAG,OAAO;IACtD,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC1D,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAG,OAAO;IAC/E,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,YAAY,EAAE,SAAS,yBAAyB,EAAE,CAAC;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,gDAAgD;IAChD,YAAY,CAAC,UAAU,EAAE,gBAAgB,GAAG,YAAY,CAAC;IACzD,QAAQ,CACN,UAAU,EAAE,gBAAgB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,oBAAoB,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC7E"}
+{"version":3,"file":"protocol-module.d.ts","sourceRoot":"","sources":["../../../src/contract/protocol-module.ts"],"names":[],"mappings":"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"}

package/contract/query-filter-fes.d.ts

@@ -0,0 +1,18 @@
+/**
+ * FES 2.0 lowering for the canonical typed filter.
+ *
+ * Split out of `query-filter.ts` so only WFS consumers pay for the FES/GML
+ * emitter: the GeoParquet, GeoServices, CQL2, and OData lowerings never reach
+ * this module's import graph.
+ *
+ * @module
+ */
+import { type FesNode } from "../core/wfs-filter.js";
+import { type QueryFilterContext, type QueryFilterExpression } from "./query-filter.js";
+/**
+ * Compile to the FES 2.0 AST the WFS adapter serializes. Spatial predicates
+ * name the feature type's geometry property, which the caller resolves (it is
+ * server-specific) and passes through `ctx.geometryProperty`.
+ */
+export declare function compileQueryFilterToFes(filter: QueryFilterExpression, ctx: QueryFilterContext): FesNode;
+//# sourceMappingURL=query-filter-fes.d.ts.map

package/contract/query-filter-fes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-filter-fes.d.ts","sourceRoot":"","sources":["../../../src/contract/query-filter-fes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAmB,KAAK,OAAO,EAAyC,MAAM,uBAAuB,CAAC;AAC7G,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAM3B,MAAM,mBAAmB,CAAC;AAkB3B;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,EAAE,kBAAkB,GAAG,OAAO,CA0EvG"}

package/contract/query-filter-fes.js

@@ -0,0 +1,122 @@
+/**
+ * FES 2.0 lowering for the canonical typed filter.
+ *
+ * Split out of `query-filter.ts` so only WFS consumers pay for the FES/GML
+ * emitter: the GeoParquet, GeoServices, CQL2, and OData lowerings never reach
+ * this module's import graph.
+ *
+ * @module
+ */
+import { UNSUPPORTED_FES, compileSpatialFilter } from "../core/wfs-filter.js";
+import { GEOSERVICES_SPATIAL_REL, assertQueryFilter, refuseQueryFilterConstruct, } from "./query-filter.js";
+const FES_COMPARISON = {
+    eq: "=",
+    ne: "<>",
+    lt: "<",
+    lte: "<=",
+    gt: ">",
+    gte: ">=",
+};
+const FES_TEMPORAL = {
+    before: "Before",
+    after: "After",
+    during: "During",
+    "time-intersects": "AnyInteracts",
+};
+/**
+ * Compile to the FES 2.0 AST the WFS adapter serializes. Spatial predicates
+ * name the feature type's geometry property, which the caller resolves (it is
+ * server-specific) and passes through `ctx.geometryProperty`.
+ */
+export function compileQueryFilterToFes(filter, ctx) {
+    assertQueryFilter(filter, ctx);
+    const emit = (node) => {
+        switch (node.kind) {
+            case "comparison": {
+                if (node.right.value === null) {
+                    const isNull = { kind: "isNull", property: node.left.name };
+                    if (node.operator === "eq")
+                        return isNull;
+                    if (node.operator === "ne")
+                        return { kind: "not", operand: isNull };
+                    return refuseQueryFilterConstruct(`filter.comparison.${node.operator}.null`, ctx);
+                }
+                return {
+                    kind: "compare",
+                    op: FES_COMPARISON[node.operator],
+                    property: node.left.name,
+                    value: fesLiteral(node.right, ctx),
+                };
+            }
+            case "list":
+                return {
+                    kind: "in",
+                    property: node.operand.name,
+                    values: node.values.map((value) => fesLiteral(value, ctx)),
+                };
+            case "range":
+                return {
+                    kind: "between",
+                    property: node.operand.name,
+                    lower: fesLiteral(node.lower, ctx),
+                    upper: fesLiteral(node.upper, ctx),
+                };
+            case "null": {
+                const isNull = { kind: "isNull", property: node.operand.name };
+                return node.operator === "is-null" ? isNull : { kind: "not", operand: isNull };
+            }
+            case "pattern":
+                if (node.caseSensitive === false)
+                    refuseQueryFilterConstruct("filter.pattern.case-insensitive", ctx);
+                return { kind: "like", property: node.operand.name, pattern: node.pattern };
+            case "spatial": {
+                const property = node.property ?? ctx.geometryProperty;
+                if (property === undefined)
+                    refuseQueryFilterConstruct("filter.spatial.geometry-property", ctx);
+                const compiled = compileSpatialFilter({
+                    geometry: node.geometry.geometry,
+                    geometryType: node.geometry.geometryType,
+                    spatialRel: fesSpatialRel(node.operator, ctx),
+                }, { geometryProperty: property });
+                if (compiled === UNSUPPORTED_FES)
+                    refuseQueryFilterConstruct(`filter.spatial.${node.operator}`, ctx);
+                return compiled;
+            }
+            case "temporal": {
+                const value = node.value;
+                const time = value.valueType === "instant" ? { instant: value.value } : { start: value.value[0], end: value.value[1] };
+                return {
+                    kind: "temporal",
+                    op: FES_TEMPORAL[node.operator],
+                    property: node.operand.name,
+                    time,
+                };
+            }
+            case "boolean":
+                return node.operator === "and"
+                    ? { kind: "and", operands: node.args.map(emit) }
+                    : { kind: "or", operands: node.args.map(emit) };
+            case "not":
+                return { kind: "not", operand: emit(node.arg) };
+            default:
+                return refuseQueryFilterConstruct("filter.node", ctx);
+        }
+    };
+    return emit(filter);
+}
+function fesSpatialRel(operator, ctx) {
+    const rel = GEOSERVICES_SPATIAL_REL[operator];
+    if (!rel)
+        refuseQueryFilterConstruct(`filter.spatial.${operator}`, ctx);
+    return rel;
+}
+function fesLiteral(node, ctx) {
+    const value = node.value;
+    if (typeof value === "number")
+        return { kind: "number", value };
+    if (typeof value === "string")
+        return { kind: "string", value };
+    if (typeof value === "boolean")
+        return { kind: "string", value: value ? "true" : "false" };
+    return refuseQueryFilterConstruct("filter.literal.null", ctx);
+}

package/contract/query-filter.d.ts

@@ -0,0 +1,300 @@
+/**
+ * Canonical typed query filter — the protocol-neutral semantic filter AST that
+ * `Source.query()` accepts on the stable surface, plus the per-protocol
+ * compilers that lower it onto each wire dialect.
+ *
+ * The AST mirrors the experimental `/query-planner` semantic filter (comparison,
+ * list, range, null, pattern, spatial, temporal, boolean composition) with two
+ * deliberate contract-layer differences:
+ *
+ * - Spatial predicates carry the same canonical geometry value the rest of the
+ *   contract uses (`SpatialFilter`-shaped `geometry` + `geometryType`, produced
+ *   by `envelope()` / `point()` / `polygon()`), so a filter composes with
+ *   `Query.spatialFilter` without a second geometry vocabulary.
+ * - Compilation is schema-free. The planner's semantic compilers verify a
+ *   `SourceSchemaV2` before emitting; the canonical surface has no verified
+ *   schema at query time, so literals are typed by the value the caller wrote.
+ *
+ * Every compiler in this module fails closed: a construct the target protocol
+ * cannot express exactly throws `HonuaCapabilityNotSupportedError` naming the
+ * construct and the protocol. Nothing is silently dropped and nothing is
+ * silently widened; a widening that is genuinely safe (the GeoParquet bbox
+ * reduction) is reported through `Result.degraded` by its adapter.
+ *
+ * @module
+ */
+import type { SpatialFilter } from "../core/spatial-filter.js";
+import type { EsriGeometryType, EsriSpatialRel } from "../core/types.js";
+/** Literal values a canonical filter may compare against. */
+export type QueryFilterScalar = string | number | boolean | null;
+/** Reference to a source field (attribute, geometry, or temporal column). */
+export interface QueryFilterPropertyNode {
+    readonly kind: "property";
+    readonly name: string;
+}
+/** Scalar literal operand. */
+export interface QueryFilterLiteralNode {
+    readonly kind: "literal";
+    readonly value: QueryFilterScalar;
+}
+export type QueryFilterComparisonOperator = "eq" | "ne" | "lt" | "lte" | "gt" | "gte";
+export interface QueryFilterComparisonNode {
+    readonly kind: "comparison";
+    readonly operator: QueryFilterComparisonOperator;
+    readonly left: QueryFilterPropertyNode;
+    readonly right: QueryFilterLiteralNode;
+}
+export interface QueryFilterListNode {
+    readonly kind: "list";
+    readonly operator: "in";
+    readonly operand: QueryFilterPropertyNode;
+    readonly values: readonly QueryFilterLiteralNode[];
+}
+export interface QueryFilterRangeNode {
+    readonly kind: "range";
+    readonly operator: "between";
+    readonly operand: QueryFilterPropertyNode;
+    readonly lower: QueryFilterLiteralNode;
+    readonly upper: QueryFilterLiteralNode;
+}
+export interface QueryFilterNullNode {
+    readonly kind: "null";
+    readonly operator: "is-null" | "is-not-null";
+    readonly operand: QueryFilterPropertyNode;
+}
+export interface QueryFilterPatternNode {
+    readonly kind: "pattern";
+    readonly operator: "like";
+    readonly operand: QueryFilterPropertyNode;
+    /** SQL-style pattern using `%` (any run) and `_` (single character). */
+    readonly pattern: string;
+    /** Defaults to `true`. `false` requests a case-insensitive match. */
+    readonly caseSensitive?: boolean;
+}
+/** Protocol-neutral spatial predicates. */
+export type QueryFilterSpatialPredicate = "intersects" | "contains" | "within" | "crosses" | "touches" | "overlaps" | "bbox-intersects";
+/** Canonical geometry operand: the value the spatial-filter builders emit. */
+export interface QueryFilterGeometryOperand {
+    readonly geometry: Record<string, unknown>;
+    readonly geometryType: EsriGeometryType;
+}
+export interface QueryFilterSpatialNode {
+    readonly kind: "spatial";
+    readonly operator: QueryFilterSpatialPredicate;
+    readonly geometry: QueryFilterGeometryOperand;
+    /**
+     * Geometry property to test. Optional for sources with a single primary
+     * geometry (GeoServices, OGC, GeoParquet); the WFS / OData compilers resolve
+     * it from the adapter when omitted.
+     */
+    readonly property?: string;
+}
+export type QueryFilterTemporalPredicate = "before" | "after" | "during" | "time-intersects";
+/** RFC 3339 instant, or an inclusive `[start, end]` interval of instants. */
+export type QueryFilterTemporalLiteralNode = {
+    readonly kind: "temporal-literal";
+    readonly valueType: "instant";
+    readonly value: string;
+} | {
+    readonly kind: "temporal-literal";
+    readonly valueType: "interval";
+    readonly value: readonly [string, string];
+};
+export interface QueryFilterTemporalNode {
+    readonly kind: "temporal";
+    readonly operator: QueryFilterTemporalPredicate;
+    readonly operand: QueryFilterPropertyNode;
+    readonly value: QueryFilterTemporalLiteralNode;
+}
+export interface QueryFilterBooleanNode {
+    readonly kind: "boolean";
+    readonly operator: "and" | "or";
+    readonly args: readonly QueryFilterExpression[];
+}
+export interface QueryFilterNotNode {
+    readonly kind: "not";
+    readonly arg: QueryFilterExpression;
+}
+/** The canonical typed filter accepted by `Query.filter`. */
+export type QueryFilterExpression = QueryFilterComparisonNode | QueryFilterListNode | QueryFilterRangeNode | QueryFilterNullNode | QueryFilterPatternNode | QueryFilterSpatialNode | QueryFilterTemporalNode | QueryFilterBooleanNode | QueryFilterNotNode;
+/**
+ * Canonical temporal filter accepted by `Query.temporalFilter`.
+ *
+ * Without `field` the filter targets the source's own time dimension and
+ * compiles to the protocol's time parameter (GeoServices `time=`, OGC / STAC
+ * `datetime=`). With `field` it compiles to an explicit temporal predicate on
+ * that column, which is the only form OData, WFS, and DuckDB can express.
+ * `null` on either interval bound means "open ended".
+ */
+export type QueryTemporalFilter = {
+    readonly kind: "instant";
+    readonly instant: string;
+    readonly field?: string;
+} | {
+    readonly kind: "interval";
+    readonly start: string | null;
+    readonly end: string | null;
+    readonly field?: string;
+};
+/**
+ * Ergonomic constructors for {@link QueryFilterExpression}. Every helper returns
+ * plain data, so a filter can equally be written as an object literal, stored as
+ * JSON, or produced by the experimental semantic builder.
+ *
+ * @example
+ * ```ts
+ * import { envelope, queryFilter } from "@honua/sdk-js";
+ *
+ * const filter = queryFilter.and(
+ *   queryFilter.eq("STATUS", "open"),
+ *   queryFilter.gt("SEVERITY", 3),
+ *   queryFilter.spatial("intersects", envelope(-158.5, 21.2, -157.6, 21.7)),
+ * );
+ * ```
+ */
+export declare const queryFilter: Readonly<{
+    eq: (field: string, value: QueryFilterScalar) => QueryFilterComparisonNode;
+    ne: (field: string, value: QueryFilterScalar) => QueryFilterComparisonNode;
+    lt: (field: string, value: QueryFilterScalar) => QueryFilterComparisonNode;
+    lte: (field: string, value: QueryFilterScalar) => QueryFilterComparisonNode;
+    gt: (field: string, value: QueryFilterScalar) => QueryFilterComparisonNode;
+    gte: (field: string, value: QueryFilterScalar) => QueryFilterComparisonNode;
+    isIn: (field: string, values: readonly QueryFilterScalar[]) => QueryFilterListNode;
+    between: (field: string, lower: QueryFilterScalar, upper: QueryFilterScalar) => QueryFilterRangeNode;
+    isNull: (field: string) => QueryFilterNullNode;
+    isNotNull: (field: string) => QueryFilterNullNode;
+    like: (field: string, pattern: string, options?: {
+        caseSensitive?: boolean;
+    }) => QueryFilterPatternNode;
+    spatial: (operator: QueryFilterSpatialPredicate, geometry: QueryFilterGeometryOperand, options?: {
+        property?: string;
+    }) => QueryFilterSpatialNode;
+    before: (field: string, instant: string) => QueryFilterTemporalNode;
+    after: (field: string, instant: string) => QueryFilterTemporalNode;
+    during: (field: string, start: string, end: string) => QueryFilterTemporalNode;
+    timeIntersects: (field: string, start: string, end: string) => QueryFilterTemporalNode;
+    and: (...args: readonly QueryFilterExpression[]) => QueryFilterBooleanNode;
+    or: (...args: readonly QueryFilterExpression[]) => QueryFilterBooleanNode;
+    not: (arg: QueryFilterExpression) => QueryFilterNotNode;
+}>;
+/** Structural bounds mirroring the semantic planner's parser limits. */
+export declare const MAX_QUERY_FILTER_DEPTH = 32;
+export declare const MAX_QUERY_FILTER_NODES = 512;
+/**
+ * Boolean, comparison, and set operators a filter can name. Mirrors the
+ * `filterOperators` vocabulary of `CapabilityConstraints` so a capability
+ * profile's allow list can gate the canonical AST without translation.
+ */
+export type QueryFilterOperatorId = QueryFilterComparisonOperator | "in" | "between" | "is-null" | "is-not-null" | "like" | "and" | "or" | "not" | QueryFilterSpatialPredicate | QueryFilterTemporalPredicate;
+/** Compilation identity used to name a refusal. */
+export interface QueryFilterContext {
+    /** Wire protocol the filter is being compiled for. */
+    readonly protocol: string;
+    /** Source id, when the compile is bound to one. */
+    readonly sourceId?: string;
+    /** Geometry property name, when the dialect must reference it explicitly. */
+    readonly geometryProperty?: string;
+    /**
+     * Operator allow list evaluated for this source. When present, an operator
+     * outside it is refused even if the protocol could express it — the source's
+     * own capability evidence is narrower than its protocol's grammar.
+     */
+    readonly supportedFilterOperators?: readonly QueryFilterOperatorId[];
+    /** Optional per-source predicate allow list from the capability profile. */
+    readonly supportedSpatialPredicates?: readonly QueryFilterSpatialPredicate[];
+    /** Optional per-source temporal predicate allow list from the capability profile. */
+    readonly supportedTemporalPredicates?: readonly QueryFilterTemporalPredicate[];
+    /**
+     * Where the allow lists came from. `capability-profile` marks a refusal as
+     * source-evidence-driven rather than protocol-driven, which the error context
+     * carries so callers can tell "this server cannot" from "this protocol
+     * cannot".
+     */
+    readonly constraintSource?: "capability-profile" | "protocol-default";
+}
+/** Fail closed, naming the construct and the protocol that cannot express it. */
+export declare function refuseQueryFilterConstruct(construct: string, ctx: QueryFilterContext): never;
+/**
+ * Narrow the evaluated `CapabilityConstraints` of one capability into the
+ * allow lists this compiler understands.
+ *
+ * Vocabularies that the canonical AST cannot name (distance predicates,
+ * extension identifiers) are dropped rather than translated, which fails closed
+ * by construction: a profile that advertises only constructs outside the AST
+ * yields an empty allow list, and every node of that kind is refused. Omitted
+ * constraint arrays stay `undefined` — "the evidence says nothing", not "the
+ * source supports nothing".
+ */
+export declare function queryFilterConstraints(constraints: {
+    readonly filterOperators?: readonly string[];
+    readonly spatialPredicates?: readonly string[];
+    readonly temporalPredicates?: readonly string[];
+}): Pick<QueryFilterContext, "supportedFilterOperators" | "supportedSpatialPredicates" | "supportedTemporalPredicates">;
+/**
+ * Validate a caller-supplied filter before any dialect sees it. Rejects
+ * malformed nodes, unbounded nesting, and identifiers that are not plain
+ * source field names (the only identifiers every dialect can quote safely).
+ */
+export declare function assertQueryFilter(filter: QueryFilterExpression, ctx: QueryFilterContext): void;
+/** Validate `Query.temporalFilter` independently of the filter AST. */
+export declare function assertTemporalFilter(temporal: QueryTemporalFilter, ctx: QueryFilterContext): void;
+/**
+ * Lower a field-bound `Query.temporalFilter` into a filter node so every
+ * dialect compiles temporal intent through the same path. Returns `undefined`
+ * when the filter targets the source's own time dimension (no `field`), which
+ * the protocol time parameter carries instead.
+ */
+export declare function temporalFilterToExpression(temporal: QueryTemporalFilter, ctx: QueryFilterContext): QueryFilterExpression | undefined;
+/** Combine a filter and a lowered temporal predicate into one expression. */
+export declare function andQueryFilters(...parts: readonly (QueryFilterExpression | undefined)[]): QueryFilterExpression | undefined;
+/** GeoServices carries the spatial predicate as request params, not as SQL. */
+export interface CompiledSql92Filter {
+    readonly where?: string;
+    readonly spatialFilter?: SpatialFilter;
+}
+/** Esri spatial relationships the canonical predicates map onto. @internal */
+export declare const GEOSERVICES_SPATIAL_REL: Record<QueryFilterSpatialPredicate, EsriSpatialRel | undefined>;
+/**
+ * Compile to the GeoServices `where` clause plus (at most one) spatial request
+ * parameter set. GeoServices expresses exactly one geometry per `query`
+ * request, and only conjunctively, so a spatial predicate nested inside `OR` /
+ * `NOT` or a second spatial predicate is refused rather than approximated.
+ */
+export declare function compileQueryFilterToSql92(filter: QueryFilterExpression, ctx: QueryFilterContext): CompiledSql92Filter;
+/** True when a filter references geometry anywhere in its tree. */
+export declare function queryFilterHasSpatial(filter: QueryFilterExpression): boolean;
+/** Emitted SQL plus whether a spatial predicate was reduced to its bbox. */
+export interface CompiledDuckDbFilter {
+    readonly sql: string;
+    readonly bboxApproximated: boolean;
+}
+/**
+ * Compile to a DuckDB `WHERE` fragment. Spatial predicates are emitted through
+ * `emitSpatial`, which the GeoParquet driver supplies (it owns the geometry
+ * column, its encoding, and the bbox reduction that `Result.degraded` reports).
+ */
+export declare function compileQueryFilterToDuckDbSql(filter: QueryFilterExpression, ctx: QueryFilterContext, emitSpatial: (node: QueryFilterSpatialNode) => {
+    readonly sql: string;
+    readonly bboxApproximated: boolean;
+}): CompiledDuckDbFilter;
+/**
+ * Compile to CQL2 text (OGC API — Features Part 3 / STAC filter extension).
+ * `geometryToWkt` is injected so the WKT writer stays in the OData module that
+ * already owns it instead of being duplicated here.
+ */
+export declare function compileQueryFilterToCql2Text(filter: QueryFilterExpression, ctx: QueryFilterContext, geometryToWkt: (geometry: Record<string, unknown>, geometryType: string) => string): string;
+/**
+ * Compile to an OData `$filter` expression. Spatial predicates are emitted
+ * through `emitSpatial` so the adapter's `$metadata`-aware geometry column and
+ * SRID resolution stay in one place.
+ */
+export declare function compileQueryFilterToOData(filter: QueryFilterExpression, ctx: QueryFilterContext, emitSpatial: (node: QueryFilterSpatialNode) => string): string;
+/**
+ * GeoServices `time=` value. Instants serialize as epoch milliseconds and
+ * intervals as `start,end`; an open bound serializes as `null`, which the
+ * FeatureServer `time` parameter defines as "unbounded on that side".
+ */
+export declare function compileTemporalFilterToGeoServicesTime(temporal: QueryTemporalFilter, ctx: QueryFilterContext): string;
+/** OGC / STAC `datetime=` value (RFC 3339 instant or `start/end` interval). */
+export declare function compileTemporalFilterToOgcDatetime(temporal: QueryTemporalFilter, ctx: QueryFilterContext): string;
+//# sourceMappingURL=query-filter.d.ts.map

package/contract/query-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-filter.d.ts","sourceRoot":"","sources":["../../../src/contract/query-filter.ts"],"names":[],"mappings":"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"}