@honua/react 0.1.0-beta.0 → 0.1.2-beta.0

package/query-planner/types.d.ts

@@ -0,0 +1,560 @@
+import type { AggregationSpec, Capability, CapabilityPolicy, Protocol, Query, Result, Source, SourceDescriptor } from "../contract/types.js";
+import { type HonuaErrorOptions, HonuaSdkError } from "../core/error-envelope.js";
+import type { GeometryEncoding } from "../core/geoparquet-sql.js";
+import type { EsriGeometryType, EsriSpatialRel } from "../core/types.js";
+import type { GeoParquetResourceHandleV1, GeoParquetResourceResolver } from "./resource.js";
+export declare const QUERY_IR_VERSION: "1.0";
+export declare const QUERY_PLAN_VERSION: "1.0";
+export declare const QUERY_IR_V2_VERSION: "2.0";
+export declare const QUERY_PLAN_V2_VERSION: "2.0";
+export declare const QUERY_PLAN_DIAGNOSTICS_VERSION: "1.0";
+export declare const QUERY_PLANNER_VERSION: "honua-query-planner@1";
+export declare const QUERY_IR_KIND: "honua.query-ir";
+export declare const QUERY_PLAN_KIND: "honua.query-plan";
+/** Hard safety ceiling for this first in-process fallback implementation. */
+export declare const MAX_LOCAL_MATERIALIZATION_ROWS = 100000;
+export type JsonPrimitive = null | boolean | number | string;
+export type JsonValue = JsonPrimitive | readonly JsonValue[] | {
+    readonly [key: string]: JsonValue;
+};
+export interface CanonicalSpatialFilter {
+    readonly geometry: {
+        readonly [key: string]: JsonValue;
+    };
+    readonly geometryType: EsriGeometryType;
+    readonly spatialRel?: EsriSpatialRel;
+}
+/**
+ * Serializable form of the current canonical {@link Query}. `AbortSignal` is
+ * deliberately excluded: cancellation belongs to execution, never identity.
+ */
+export interface CanonicalQuery {
+    /** The current contract carries a source-native string escape hatch. */
+    readonly where?: {
+        readonly kind: "source-native";
+        readonly expression: string;
+    };
+    readonly spatialFilter?: CanonicalSpatialFilter;
+    readonly outFields?: readonly string[];
+    readonly orderBy?: readonly {
+        readonly field: string;
+        readonly direction: "asc" | "desc";
+    }[];
+    readonly pagination?: {
+        readonly offset?: number;
+        readonly limit?: number;
+    };
+    readonly aggregation?: AggregationSpec;
+    readonly returnGeometry?: boolean;
+    readonly outSr?: string | number;
+}
+export interface QueryIrSourceIdentity {
+    readonly id: string;
+    readonly protocol: Protocol;
+    /** Credential-free endpoint identity: origin/path plus protocol locator ids. */
+    readonly endpoint: string;
+    readonly serviceId?: string;
+    readonly layerId?: number;
+    readonly collectionId?: string | number;
+    readonly typeName?: string;
+    readonly entitySet?: string;
+    /** Descriptor-derived geometry property used by the metadata-free OData compiler. */
+    readonly geometryProperty?: string;
+    readonly srsName?: string;
+    /** Bounded, credential-screened schema version identity. */
+    readonly schemaVersion?: string;
+    /** Bounded, credential-screened source version identity. */
+    readonly sourceVersion?: string;
+    /** DuckDB/GeoParquet addressing derived from the descriptor for the SQL compiler. */
+    readonly geoparquet?: QueryIrGeoparquetIdentity;
+    readonly authorizationScope: readonly string[];
+    readonly capabilities: readonly Capability[];
+}
+/**
+ * Physical geometry encoding of a GeoParquet column, per the DuckDB SQL
+ * compiler. Re-exports {@link GeometryEncoding} (`core/geoparquet-sql.ts`) so
+ * the planner's compiled-query artifacts and the live `Source` never drift on
+ * which encodings exist — including the GeoParquet 1.1 `geoarrow-*` native
+ * single-geometry encodings, which have no DuckDB spatial-predicate
+ * expression (`geometryExpr` throws for them; see that module).
+ */
+export type DuckDbGeometryEncoding = GeometryEncoding;
+/**
+ * Deterministic GeoParquet addressing carried on the IR so the DuckDB SQL
+ * compiler can build `read_parquet(...)` SQL with spatial pushdown without a
+ * profiling round-trip. Derived from `locator.url`, `locator.geoparquet`, and
+ * the descriptor schema.
+ */
+export interface QueryIrGeoparquetIdentity {
+    /** Parquet file URL(s) / hive glob(s) read as one relation. */
+    readonly sources: readonly string[];
+    /** Geometry column name, when the source is spatial. */
+    readonly geometryColumn?: string;
+    /** Physical encoding of the geometry column (defaults to `wkb`). */
+    readonly geometryEncoding?: DuckDbGeometryEncoding;
+    /** Optional GeoParquet 1.1 bbox-covering struct column for row-group pruning. */
+    readonly bboxColumn?: string;
+    /** Coordinate dimensions for a `geoarrow-*` `geometryEncoding` (GeoParquet 1.1 native). */
+    readonly nativeDimensions?: "xy" | "xyz";
+}
+/**
+ * One projected DuckDB output field of an effective GeoParquet schema: the
+ * exact name/type/nullable evidence {@link module:geoparquet/lossless-decoder}
+ * needs to compile a lossless row decoder without a runtime `DESCRIBE`.
+ */
+export interface GeoParquetEffectiveSchemaFieldV1 {
+    readonly name: string;
+    /** Effective DuckDB DESCRIBE type text (e.g. `BIGINT`, `DECIMAL(20,5)`). */
+    readonly type: string;
+    readonly nullable?: boolean;
+}
+/** Credential-free GeoParquet identity used by v2 plans. */
+export interface QueryIrGeoparquetResourceIdentity {
+    readonly resource: GeoParquetResourceHandleV1;
+    /** Geometry metadata is safe planner input and never requires locator resolution. */
+    readonly geometryColumn?: string;
+    readonly geometryEncoding?: DuckDbGeometryEncoding;
+    readonly bboxColumn?: string;
+    /** Coordinate dimensions for a `geoarrow-*` `geometryEncoding` (GeoParquet 1.1 native). */
+    readonly nativeDimensions?: "xy" | "xyz";
+    /**
+     * Validated, versioned effective DuckDB output schema bound to this plan so
+     * opaque `resultEncoding: "lossless-json"` execution can decode exactly,
+     * without profiling the resolved locator (#627). Absent for legacy/default
+     * result encoding.
+     */
+    readonly effectiveSchema?: readonly GeoParquetEffectiveSchemaFieldV1[];
+}
+/** GeoParquet-only v2 source identity. Raw locators are deliberately absent. */
+export interface QueryIrSourceIdentityV2 {
+    /** Stable logical id copied from the validated opaque handle. */
+    readonly id: string;
+    readonly protocol: "geoparquet";
+    readonly endpoint: "[opaque-resource]";
+    /** Safe descriptor metadata needed to reconstruct bounded-local plans exactly. */
+    readonly primaryKey?: string;
+    readonly schemaVersion?: string;
+    readonly sourceVersion?: string;
+    readonly geoparquet: QueryIrGeoparquetResourceIdentity;
+    readonly authorizationScope: readonly string[];
+    readonly capabilities: readonly Capability[];
+}
+export interface QueryIrV1 {
+    readonly kind: typeof QUERY_IR_KIND;
+    readonly version: typeof QUERY_IR_VERSION;
+    readonly source: QueryIrSourceIdentity;
+    readonly query: CanonicalQuery;
+}
+export interface QueryIrV2 {
+    readonly kind: typeof QUERY_IR_KIND;
+    readonly version: typeof QUERY_IR_V2_VERSION;
+    readonly source: QueryIrSourceIdentityV2;
+    readonly query: CanonicalQuery;
+}
+export type QueryFallbackPolicy = {
+    readonly mode: "disabled";
+} | {
+    readonly mode: "bounded-local";
+    /** Maximum feature objects that may enter local execution. */
+    readonly maxRows: number;
+    /** Optional additional ceiling measured from the materialized JSON payload. */
+    readonly maxBytes?: number;
+};
+export interface QueryPlanningEstimates {
+    readonly rows?: number;
+    readonly bytes?: number;
+    readonly requests?: number;
+}
+export type QueryPlanBoundConfidence = "exact" | "bounded" | "estimated" | "unknown";
+export type QueryPlanBoundSource = "compiler" | "query-limit" | "fallback-policy" | "caller-estimate" | "plan-summary" | "unavailable";
+/** One deterministic quantity bound. Missing numbers are deliberately unknown, never zero. */
+export interface QueryPlanQuantityBound {
+    readonly unit: "request" | "row" | "byte";
+    readonly confidence: QueryPlanBoundConfidence;
+    readonly source: QueryPlanBoundSource;
+    readonly lower?: number;
+    readonly upper?: number;
+    readonly estimate?: number;
+}
+/** Versioned cost and safety bounds used at both plan and step scope. */
+export interface QueryPlanBoundsV1 {
+    readonly version: typeof QUERY_PLAN_DIAGNOSTICS_VERSION;
+    readonly requests: QueryPlanQuantityBound;
+    readonly rows: QueryPlanQuantityBound;
+    readonly bytes: QueryPlanQuantityBound;
+    readonly transferBytes: QueryPlanQuantityBound;
+    /** UTF-8 bytes of the deterministic serialized materialization checked by the executor. */
+    readonly serializedMaterializationBytes: QueryPlanQuantityBound;
+    /** Actual JavaScript heap use. Unknown unless a runtime supplies direct evidence. */
+    readonly memoryBytes: QueryPlanQuantityBound;
+}
+export type QueryPlanCachePolicy = "bypass" | "prefer-cache" | "require-fresh";
+export type QueryPlanCacheFreshness = "fresh" | "stale" | "unknown";
+export type QueryPlanCacheAction = "bypass" | "reuse" | "revalidate" | "refresh";
+export type QueryPlanValidatorKind = "etag" | "last-modified" | "revision" | "fingerprint";
+export interface QueryPlanValidatorInput {
+    readonly kind: QueryPlanValidatorKind;
+    /** Raw validators are accepted at planning only and persisted as a digest. */
+    readonly value?: string;
+    /** Safe reconstruction path for already-digested persisted provenance. */
+    readonly fingerprint?: `sha256:${string}`;
+}
+export interface QueryPlanCacheOptions {
+    readonly policy?: QueryPlanCachePolicy;
+    readonly freshness?: QueryPlanCacheFreshness;
+    readonly validator?: QueryPlanValidatorInput;
+}
+export interface QueryPlanCacheDecisionV1 {
+    readonly version: typeof QUERY_PLAN_DIAGNOSTICS_VERSION;
+    readonly policy: QueryPlanCachePolicy;
+    readonly action: QueryPlanCacheAction;
+    readonly freshness: QueryPlanCacheFreshness;
+    readonly validator?: {
+        readonly kind: QueryPlanValidatorKind;
+        readonly fingerprint: `sha256:${string}`;
+    };
+    readonly reason: "policy-bypass" | "fresh-entry" | "validator-available" | "stale-entry" | "cache-miss";
+}
+export type QueryPlanFidelity = "exact" | "equivalent" | "approximate";
+export interface QueryPlanFidelityLoss {
+    readonly code: "spatial-envelope-reduction";
+    readonly path: string;
+    readonly description: string;
+    readonly remediation: string;
+}
+export type QueryPlanDiscoveryState = "metadata" | "declared" | "inferred" | "unavailable";
+export interface QueryPlanDiscoveryContext {
+    readonly state: QueryPlanDiscoveryState;
+    /** Raw discovery source is planning-only and persisted as a digest. */
+    readonly source?: string;
+    readonly sourceFingerprint?: `sha256:${string}`;
+    readonly validator?: QueryPlanValidatorInput;
+}
+export interface QueryPlanProvenanceV1 {
+    readonly version: typeof QUERY_PLAN_DIAGNOSTICS_VERSION;
+    readonly source: {
+        readonly id: string;
+        readonly protocol: Protocol;
+        readonly endpointFingerprint: `sha256:${string}`;
+        readonly descriptorFingerprint: `sha256:${string}`;
+        readonly versionFingerprint?: `sha256:${string}`;
+    };
+    readonly schema: {
+        readonly state: "known";
+        readonly fingerprint: `sha256:${string}`;
+        readonly basis: "schema-v2" | "version";
+    } | {
+        readonly state: "unavailable";
+        readonly reason: "not-provided";
+    };
+    readonly discovery: {
+        readonly state: QueryPlanDiscoveryState;
+        readonly sourceFingerprint?: `sha256:${string}`;
+        readonly validator?: {
+            readonly kind: QueryPlanValidatorKind;
+            readonly fingerprint: `sha256:${string}`;
+        };
+        readonly fingerprint: `sha256:${string}`;
+    };
+    readonly authorizationScope: {
+        readonly fingerprint: `sha256:${string}`;
+        readonly count: number;
+    };
+}
+export interface QueryPlanStepProvenanceV1 {
+    readonly version: typeof QUERY_PLAN_DIAGNOSTICS_VERSION;
+    readonly sourceFingerprint: `sha256:${string}`;
+    readonly schemaFingerprint?: `sha256:${string}`;
+    readonly discoveryFingerprint: `sha256:${string}`;
+    readonly authorizationScopeFingerprint: `sha256:${string}`;
+}
+export type QueryPlanExecutionMode = "snapshot" | "delta";
+export interface QueryPlanValidityV1 {
+    readonly version: typeof QUERY_PLAN_DIAGNOSTICS_VERSION;
+    readonly plannerVersion: typeof QUERY_PLANNER_VERSION;
+    readonly contractVersion: string;
+    readonly executionMode: QueryPlanExecutionMode;
+    readonly sourceFingerprint: `sha256:${string}`;
+    readonly schemaFingerprint: `sha256:${string}`;
+    readonly discoveryFingerprint: `sha256:${string}`;
+    readonly authorizationScopeFingerprint: `sha256:${string}`;
+    readonly queryFingerprint: `sha256:${string}`;
+    readonly crsFingerprint: `sha256:${string}`;
+    readonly policyFingerprint: `sha256:${string}`;
+    readonly fingerprint: `sha256:${string}`;
+}
+export type QueryPlanWarningCode = "bounded-local-fallback" | "geometry-transfer-required" | "approximate-spatial-filter";
+export interface QueryPlanWarning {
+    readonly code: QueryPlanWarningCode;
+    readonly severity: "warning";
+    readonly path: string;
+    readonly message: string;
+    readonly remediation: string;
+}
+export interface ExplainQueryOptions<T = Record<string, unknown>> {
+    readonly descriptor: SourceDescriptor;
+    readonly query?: Readonly<Query<T>>;
+    readonly capabilityPolicy?: CapabilityPolicy;
+    readonly fallback?: QueryFallbackPolicy;
+    readonly schemaVersion?: string;
+    readonly sourceVersion?: string;
+    /** Stable scope identifiers only. Never pass credentials or tokens. */
+    readonly authorizationScope?: readonly string[];
+    /** Caller-supplied metadata estimates; explaining never reads result data. */
+    readonly estimates?: QueryPlanningEstimates;
+    /** Stable cache state only. Observation clocks never enter a plan fingerprint. */
+    readonly cache?: QueryPlanCacheOptions;
+    /** Credential-safe discovery identity. Raw sources/validators are digested. */
+    readonly discovery?: QueryPlanDiscoveryContext;
+    /** Realtime delta plans carry mode only; live cursor bytes remain transport state. */
+    readonly executionMode?: QueryPlanExecutionMode;
+}
+/** Opt-in GeoParquet v2 planning options. */
+export interface ExplainGeoParquetQueryOptions<T = Record<string, unknown>> extends ExplainQueryOptions<T> {
+    /** Opaque stable identity; the locator remains private to the injected resolver. */
+    readonly geoparquetResource: GeoParquetResourceHandleV1;
+    /**
+     * Trustworthy effective DuckDB output schema for this resource, established
+     * out-of-band by the trusted plan author (#627). Required to bind a plan
+     * that a `resultEncoding: "lossless-json"` source can execute opaquely.
+     */
+    readonly effectiveSchema?: readonly GeoParquetEffectiveSchemaFieldV1[];
+}
+export interface GeoServicesCompiledQueryV1 {
+    readonly compiler: "geoservices-rest-query-v1";
+    readonly serviceId: string;
+    readonly layerId: number;
+    readonly where?: string;
+    readonly outFields?: readonly string[];
+    readonly returnGeometry?: boolean;
+    readonly outSr?: string | number;
+    readonly orderByFields?: string;
+    readonly geometry?: {
+        readonly [key: string]: JsonValue;
+    };
+    readonly geometryType?: EsriGeometryType;
+    readonly spatialRel?: EsriSpatialRel;
+    readonly resultOffset?: number;
+    readonly resultRecordCount?: number;
+    readonly outStatistics?: readonly {
+        readonly statisticType: string;
+        readonly onStatisticField: string;
+        readonly outStatisticFieldName: string;
+    }[];
+    readonly groupByFieldsForStatistics?: string;
+}
+/** Inspectable OGC API Features `/items` request produced without I/O. */
+export interface OgcApiFeaturesCompiledQueryV1 {
+    readonly compiler: "ogc-api-features-query-v1";
+    readonly collectionId: string | number;
+    readonly filter?: string;
+    readonly filterLang?: "cql2-text";
+    readonly properties?: readonly string[];
+    readonly sortby?: string;
+    readonly bbox?: string;
+    readonly crs?: string;
+    readonly offset?: number;
+    readonly limit?: number;
+}
+/** Inspectable WFS 2.0 GetFeature request produced without I/O. */
+export interface WfsCompiledQueryV1 {
+    readonly compiler: "wfs-2.0-get-feature-v1";
+    readonly typeName: string;
+    readonly filter?: string;
+    readonly propertyName?: readonly string[];
+    readonly sortBy?: string;
+    readonly startIndex?: number;
+    readonly count?: number;
+    readonly srsName?: string;
+}
+/** Inspectable OData v4 entity-set query produced without I/O. */
+export interface OdataCompiledQueryV1 {
+    readonly compiler: "odata-v4-query-v1";
+    readonly entitySet: string;
+    readonly filter?: string;
+    readonly select?: readonly string[];
+    readonly expand?: readonly string[];
+    readonly orderBy?: readonly string[];
+    readonly skip?: number;
+    readonly top?: number;
+}
+/** Inspectable DuckDB `SELECT` over `read_parquet(...)` produced without I/O. */
+export interface DuckDbCompiledQueryV1 {
+    readonly compiler: "duckdb-sql-v1";
+    /** Deterministic, injection-safe DuckDB SQL text. */
+    readonly sql: string;
+    /** Parquet file URL(s) / glob(s) the SQL reads. */
+    readonly sources: readonly string[];
+    readonly geometryColumn?: string;
+    readonly geometryEncoding?: DuckDbGeometryEncoding;
+    /** True when a non-envelope spatial filter was reduced to its bounding box. */
+    readonly bboxApproximated?: boolean;
+}
+/** Credential-free DuckDB template compiled for execution-time resource binding. */
+export interface DuckDbCompiledQueryV2 {
+    readonly compiler: "duckdb-sql-v2";
+    /** Inspectable SQL over a fixed non-runnable placeholder, never a raw locator. */
+    readonly sqlTemplate: string;
+    readonly resource: GeoParquetResourceHandleV1;
+    readonly geometryColumn?: string;
+    readonly geometryEncoding?: DuckDbGeometryEncoding;
+    readonly bboxApproximated?: boolean;
+}
+/** Proto spatial-relationship enum value name emitted by the gRPC compiler. */
+export type GrpcSpatialRelationship = "SPATIAL_RELATIONSHIP_INTERSECTS" | "SPATIAL_RELATIONSHIP_WITHIN" | "SPATIAL_RELATIONSHIP_CONTAINS" | "SPATIAL_RELATIONSHIP_ENVELOPE_INTERSECTS" | "SPATIAL_RELATIONSHIP_CROSSES" | "SPATIAL_RELATIONSHIP_TOUCHES" | "SPATIAL_RELATIONSHIP_OVERLAPS" | "SPATIAL_RELATIONSHIP_DISJOINT";
+/** Proto statistic-type enum value name emitted by the gRPC compiler. */
+export type GrpcStatisticType = "STATISTIC_TYPE_COUNT" | "STATISTIC_TYPE_SUM" | "STATISTIC_TYPE_MIN" | "STATISTIC_TYPE_MAX" | "STATISTIC_TYPE_AVG" | "STATISTIC_TYPE_STDDEV" | "STATISTIC_TYPE_VAR";
+/**
+ * Inspectable `honua.v1.FeatureService/QueryFeatures` unary request produced
+ * without pulling in the protobuf runtime. Field names and enum value names
+ * mirror the generated `QueryFeaturesRequest` message so the plan is a faithful,
+ * deterministic description of the wire request.
+ */
+export interface GrpcCompiledQueryV1 {
+    readonly compiler: "honua-grpc-query-features-v1";
+    readonly service: "honua.v1.FeatureService";
+    readonly method: "QueryFeatures";
+    readonly serviceId: string;
+    readonly layerId: number;
+    readonly where?: string;
+    readonly outFields?: readonly string[];
+    readonly returnGeometry?: boolean;
+    readonly outSr?: string | number;
+    readonly orderBy?: string;
+    readonly resultOffset?: number;
+    readonly resultRecordCount?: number;
+    readonly spatialFilter?: {
+        readonly geometry: {
+            readonly [key: string]: JsonValue;
+        };
+        readonly geometryType: EsriGeometryType;
+        readonly spatialRelationship: GrpcSpatialRelationship;
+    };
+    readonly outStatistics?: readonly {
+        readonly statisticType: GrpcStatisticType;
+        readonly onStatisticField: string;
+        readonly outStatisticFieldName: string;
+    }[];
+    readonly groupBy?: readonly string[];
+}
+export type RemoteCompiledQueryV1 = GeoServicesCompiledQueryV1 | OgcApiFeaturesCompiledQueryV1 | WfsCompiledQueryV1 | OdataCompiledQueryV1 | DuckDbCompiledQueryV1 | GrpcCompiledQueryV1;
+export interface RemoteQueryPlanStep {
+    readonly id: string;
+    readonly engine: "remote";
+    readonly operation: "query" | "queryAll" | "queryAggregate";
+    readonly pushdown: "full" | "partial";
+    readonly fidelity: QueryPlanFidelity;
+    readonly losses: readonly QueryPlanFidelityLoss[];
+    readonly bounds: QueryPlanBoundsV1;
+    readonly provenance: QueryPlanStepProvenanceV1;
+    readonly reason: string;
+    readonly requests: number;
+    readonly query: CanonicalQuery;
+    readonly compiled: RemoteCompiledQueryV1;
+}
+export interface GeoParquetRemoteQueryPlanStepV2 {
+    readonly id: string;
+    readonly engine: "remote";
+    readonly operation: "query" | "queryAll" | "queryAggregate";
+    readonly pushdown: "full" | "partial";
+    readonly fidelity: QueryPlanFidelity;
+    readonly losses: readonly QueryPlanFidelityLoss[];
+    readonly bounds: QueryPlanBoundsV1;
+    readonly provenance: QueryPlanStepProvenanceV1;
+    readonly reason: string;
+    readonly requests: number;
+    readonly query: CanonicalQuery;
+    readonly compiled: DuckDbCompiledQueryV2;
+}
+export interface LocalAggregatePlanStep {
+    readonly id: string;
+    readonly engine: "client";
+    readonly operation: "aggregate";
+    readonly pushdown: "none";
+    readonly fidelity: "equivalent";
+    readonly losses: readonly QueryPlanFidelityLoss[];
+    readonly bounds: QueryPlanBoundsV1;
+    readonly provenance: QueryPlanStepProvenanceV1;
+    readonly reason: string;
+    readonly inputStepId: string;
+    readonly aggregation: AggregationSpec;
+    readonly maxRows: number;
+    readonly maxBytes?: number;
+}
+export type QueryPlanStep = RemoteQueryPlanStep | LocalAggregatePlanStep;
+export type QueryPlanStepV2 = GeoParquetRemoteQueryPlanStepV2 | LocalAggregatePlanStep;
+export interface QueryExecutionPlanV1 {
+    readonly kind: typeof QUERY_PLAN_KIND;
+    readonly version: typeof QUERY_PLAN_VERSION;
+    readonly id: string;
+    readonly fingerprint: `sha256:${string}`;
+    readonly ir: QueryIrV1;
+    readonly capabilityPolicy: CapabilityPolicy;
+    readonly fallback: QueryFallbackPolicy;
+    readonly pushdown: "full" | "partial";
+    readonly diagnosticsVersion: typeof QUERY_PLAN_DIAGNOSTICS_VERSION;
+    readonly fidelity: QueryPlanFidelity;
+    readonly losses: readonly QueryPlanFidelityLoss[];
+    readonly bounds: QueryPlanBoundsV1;
+    readonly cache: QueryPlanCacheDecisionV1;
+    readonly provenance: QueryPlanProvenanceV1;
+    readonly validity: QueryPlanValidityV1;
+    readonly estimates: QueryPlanningEstimates;
+    readonly steps: readonly QueryPlanStep[];
+    readonly warnings: readonly QueryPlanWarning[];
+}
+export interface QueryExecutionPlanV2 {
+    readonly kind: typeof QUERY_PLAN_KIND;
+    readonly version: typeof QUERY_PLAN_V2_VERSION;
+    readonly id: string;
+    readonly fingerprint: `sha256:${string}`;
+    readonly ir: QueryIrV2;
+    readonly capabilityPolicy: CapabilityPolicy;
+    readonly fallback: QueryFallbackPolicy;
+    readonly pushdown: "full" | "partial";
+    readonly diagnosticsVersion: typeof QUERY_PLAN_DIAGNOSTICS_VERSION;
+    readonly fidelity: QueryPlanFidelity;
+    readonly losses: readonly QueryPlanFidelityLoss[];
+    readonly bounds: QueryPlanBoundsV1;
+    readonly cache: QueryPlanCacheDecisionV1;
+    readonly provenance: QueryPlanProvenanceV1;
+    readonly validity: QueryPlanValidityV1;
+    readonly estimates: QueryPlanningEstimates;
+    readonly steps: readonly QueryPlanStepV2[];
+    readonly warnings: readonly QueryPlanWarning[];
+}
+export type QueryExecutionPlan = QueryExecutionPlanV1 | QueryExecutionPlanV2;
+export type QueryPlanningErrorCode = "invalid-query" | "unsupported-compiler" | "unsupported-query" | "capability-not-supported" | "fallback-disabled" | "unsafe-materialization";
+export declare class HonuaQueryPlanningError extends HonuaSdkError {
+    readonly code: QueryPlanningErrorCode;
+    constructor(code: QueryPlanningErrorCode, message: string, options?: HonuaErrorOptions);
+}
+export type QueryPlanExecutionErrorCode = "invalid-plan" | "plan-context-mismatch" | "stale-plan" | "foreign-plan" | "unsafe-materialization" | "invalid-resource-handle" | "resource-unavailable" | "resource-expired" | "resource-resolution-failed" | "resource-execution-failed";
+export declare class HonuaQueryPlanExecutionError extends HonuaSdkError {
+    readonly code: QueryPlanExecutionErrorCode;
+    readonly reason?: QueryPlanExecutionFailureReason | undefined;
+    constructor(code: QueryPlanExecutionErrorCode, message: string, options?: HonuaErrorOptions, reason?: QueryPlanExecutionFailureReason | undefined);
+}
+export interface ExecuteQueryPlanOptions {
+    readonly signal?: AbortSignal;
+    readonly schemaVersion?: string;
+    readonly sourceVersion?: string;
+    readonly authorizationScope?: readonly string[];
+    readonly discovery?: QueryPlanDiscoveryContext;
+    readonly executionMode?: QueryPlanExecutionMode;
+    /** Exact non-secret partition id required by a GeoParquet v2 resource handle. */
+    readonly authorizationContextId?: string;
+    /** Lifecycle-scoped resolver used only at the trusted v2 execution boundary. */
+    readonly geoParquetResourceResolver?: GeoParquetResourceResolver;
+    /** Must match the effective schema the plan was explained with (#627). */
+    readonly effectiveSchema?: readonly GeoParquetEffectiveSchemaFieldV1[];
+}
+export type QueryPlanExecutionFailureReason = "source-identity-changed" | "authorization-scope-changed" | "source-version-changed" | "schema-changed" | "capabilities-changed" | "discovery-changed" | "execution-mode-changed";
+export interface QueryPlanExecution<T = Record<string, unknown>> {
+    readonly planId: string;
+    readonly fingerprint: `sha256:${string}`;
+    readonly result: Result<T>;
+}
+/** Executor signature exported for dependency injection and test doubles. */
+export type QueryPlanExecutor = <T>(plan: QueryExecutionPlan, source: Source<T>, options?: ExecuteQueryPlanOptions) => Promise<QueryPlanExecution<T>>;
+//# sourceMappingURL=types.d.ts.map

package/query-planner/types.d.ts.map

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

package/query-planner/types.js

@@ -0,0 +1,49 @@
+import { HonuaSdkError } from "../core/error-envelope.js";
+export const QUERY_IR_VERSION = "1.0";
+export const QUERY_PLAN_VERSION = "1.0";
+export const QUERY_IR_V2_VERSION = "2.0";
+export const QUERY_PLAN_V2_VERSION = "2.0";
+export const QUERY_PLAN_DIAGNOSTICS_VERSION = "1.0";
+export const QUERY_PLANNER_VERSION = "honua-query-planner@1";
+export const QUERY_IR_KIND = "honua.query-ir";
+export const QUERY_PLAN_KIND = "honua.query-plan";
+/** Hard safety ceiling for this first in-process fallback implementation. */
+export const MAX_LOCAL_MATERIALIZATION_ROWS = 100_000;
+export class HonuaQueryPlanningError extends HonuaSdkError {
+    code;
+    constructor(code, message, options = {}) {
+        super(QUERY_PLANNING_CODES[code], message, options);
+        this.code = code;
+        this.name = "HonuaQueryPlanningError";
+    }
+}
+export class HonuaQueryPlanExecutionError extends HonuaSdkError {
+    code;
+    reason;
+    constructor(code, message, options = {}, reason) {
+        super(QUERY_EXECUTION_CODES[code], message, options);
+        this.code = code;
+        this.reason = reason;
+        this.name = "HonuaQueryPlanExecutionError";
+    }
+}
+const QUERY_PLANNING_CODES = {
+    "invalid-query": "query.planning.invalid-query",
+    "unsupported-compiler": "query.planning.unsupported-compiler",
+    "unsupported-query": "query.planning.unsupported-query",
+    "capability-not-supported": "query.planning.capability-not-supported",
+    "fallback-disabled": "query.planning.fallback-disabled",
+    "unsafe-materialization": "query.planning.unsafe-materialization",
+};
+const QUERY_EXECUTION_CODES = {
+    "invalid-plan": "query.execution.invalid-plan",
+    "plan-context-mismatch": "query.execution.plan-context-mismatch",
+    "stale-plan": "query.execution.plan-context-mismatch",
+    "foreign-plan": "query.execution.plan-context-mismatch",
+    "unsafe-materialization": "query.execution.unsafe-materialization",
+    "invalid-resource-handle": "query.execution.invalid-resource-handle",
+    "resource-unavailable": "query.execution.resource-unavailable",
+    "resource-expired": "query.execution.resource-expired",
+    "resource-resolution-failed": "query.execution.resource-resolution-failed",
+    "resource-execution-failed": "query.execution.resource-execution-failed",
+};