Module query-plannerExperimental

@honua/sdk-js/query-planner — deterministic query IR, explain plans, and bounded execution for the protocol-neutral contract.

Planning is synchronous and side-effect free: it uses a caller-supplied descriptor/capability snapshot and never fetches metadata or result rows. Execution is separate and validates the accepted fingerprint and source context before invoking a Source.

References

Classes

Interfaces

ApacheArrowAdapterMetrics ApacheArrowAdapterOptions ApacheArrowDataLike ApacheArrowFieldLike ApacheArrowRecordBatchLike ApacheArrowRecordBatchResult ApacheArrowTypeLike ApacheArrowVectorLike ApplyColumnarPatchOptions CanonicalSemanticQueryOptions ColumnarBatchCacheAdmissionV1 ColumnarBatchCacheConformanceCaseResultV1 ColumnarBatchCacheConformanceOptions ColumnarBatchCacheConformanceReportV1 ColumnarBatchCacheDiagnosticV1 ColumnarBatchCacheEntryV1 ColumnarBatchCacheFreshnessV1 ColumnarBatchCacheHandle ColumnarBatchCacheOptions ColumnarBatchCacheReadOptions ColumnarBatchCacheRecordV1 ColumnarBatchCacheStorage ColumnarBatchCacheWriteOptions ColumnarBatchIdentityFromPlanOptions ColumnarBatchIdentityV1 ColumnarBatchLimits ColumnarBatchMetrics ColumnarBatchToResultOptions ColumnarBatchToResultPagesOptions ColumnarBatchV1 ColumnarBufferV1 ColumnarFieldV1 ColumnarFreshnessV1 ColumnarOrderingKeyV1 ColumnarOrderingV1 ColumnarPatchAppendV1 ColumnarPatchAppliedInPlaceV1 ColumnarPatchCapacityV1 ColumnarPatchCursorV1 ColumnarPatchDeleteV1 ColumnarPatchMetricsV1 ColumnarPatchRebuildOptions ColumnarPatchRebuiltV1 ColumnarPatchRejectedV1 ColumnarPatchReserveV1 ColumnarPatchStateV1 ColumnarPatchThresholds ColumnarPatchUpdateV1 ColumnarPatchV1 ColumnarResult ColumnarResultAttributeBinding ColumnarResultDictionaryBinding ColumnarResultFeatureIdBinding ColumnarResultGeometryDescriptor ColumnarResultProvenance ColumnarResultTemporalBinding ColumnarSchemaV1 ColumnarTelemetry ColumnarTelemetryIdentityV1 ColumnarTelemetryOptions ColumnarTelemetrySpan ColumnarTelemetrySpanResult ColumnarTransferMessageV1 ColumnarTransferOptions ColumnarTransferReceipt ColumnarTypeV1 ColumnarWorkerCancelV1 ColumnarWorkerErrorV1 ColumnarWorkerExecutionProgress ColumnarWorkerExecutionResult ColumnarWorkerFaultEvent ColumnarWorkerHost ColumnarWorkerMessageEvent ColumnarWorkerOperationContext ColumnarWorkerProgressV1 ColumnarWorkerRequestV1 ColumnarWorkerResultV1 ColumnarWorkerSession ColumnarWorkerTransport Cql2JsonInterchangeOptions CreateColumnarBatchInput CreateColumnarPatchInput CreateColumnarPatchOperationOptions CreateColumnarWorkerSessionOptions CreatedGeoArrowBatch CreatedPatchableGeoArrowBatch CreateGeoArrowAggregateOperationOptions CreateGeoArrowBatchInput CreateGeoArrowReprojectOperationOptions CreateGeoParquetResourceHandleInput CreatePatchableGeoArrowBatchOptions DecodedGeoArrowBatch DecodedGeoArrowRow DecodedPatchedGeoArrowBatch DistanceOperand DuckDbCompiledQueryV1 DuckDbCompiledQueryV2 ExecuteColumnarWorkerOperationOptions ExplainGeoParquetQueryOptions FirstPageRequest FromApacheArrowRecordBatchOptions GeoArrowAggregateDictionaryGroupSpec GeoArrowAggregateGridGroupSpec GeoArrowAggregateMetricSpec GeoArrowAggregateResult GeoArrowAggregateRow GeoArrowAggregateSource GeoArrowAggregateTemporalGroupSpec GeoArrowBatchFromApacheResult GeoArrowBatchInspection GeoArrowBatchSerializationResult GeoArrowConversionLimits GeoArrowConversionMetrics GeoArrowDictionaryBuffers GeoArrowDictionaryColumnInput GeoArrowEnvelopeMigrationV1 GeoArrowFeatureIdColumnInput GeoArrowGeometryBuffers GeoArrowLineStringColumnInput GeoArrowPointColumnInput GeoArrowPolygonColumnInput GeoArrowSerializationMetrics GeoArrowSerializationOptions GeoArrowTemporalBuffers GeoArrowTemporalColumnInput GeoParquetEffectiveSchemaFieldV1 GeoParquetRemoteQueryPlanStepV2 GeoParquetResolverResourceReferenceV1 GeoParquetResourceHandleV1 GeoParquetResourceRegistry GeoParquetResourceRegistryOptions GeoParquetResourceResolutionContext GeoServicesCompiledQueryV1 GrpcCompiledQueryV1 IndexedDbColumnarBatchCacheStorageOptions LiteralNode LoadApacheArrowOptions NullNode OdataCompiledQueryV1 OdataProtocolCompiledQueryV1 OdataProtocolExecutionQuery OdataProtocolQueryBinding OffsetPageRequest OgcApiFeaturesCompiledQueryV1 OgcApiFeaturesFilterConformanceEvidence ParseSemanticQueryOptions PatchableGeoArrowBatchMetrics PatternNode PropertyNode QueryExecutionPlanV2 QueryIrGeoparquetIdentity QueryIrGeoparquetResourceIdentity QueryIrSourceIdentityV2 QueryIrV2 QueryPlanBoundsV1 QueryPlanCacheDecisionV1 QueryPlanCacheOptions QueryPlanDiscoveryContext QueryPlanFidelityLoss QueryPlanProvenanceV1 QueryPlanQuantityBound QueryPlanRepresentationDecisionV1 QueryPlanRepresentationInputsV1 QueryPlanStepProvenanceV1 QueryPlanValidatorInput QueryPlanValidityV1 QueryPlanWarning RegisterGeoParquetResourceInput ResolvedGeoParquetResource ResultToColumnarBatchAttributeOptions ResultToColumnarBatchGeometryOptions ResultToColumnarBatchOptions ResultToColumnarBatchResult SemanticAggregateQuery SemanticCompilerDiagnostic SemanticCompilerFieldMapping SemanticCompilerLoss SemanticDuckDbCompiledQueryV1 SemanticDuckDbCompileOptions SemanticDuckDbGeometrySource SemanticDuckDbOutputGeometry SemanticDuckDbSpatialCompilation SemanticFeatureQuery SemanticGeoServicesCompiledQueryV1 SemanticGeoServicesCompileOptions SemanticGeoServicesSourceIdentity SemanticGeoServicesSpatialReference SemanticGrpcCompiledQueryV1 SemanticGrpcCompileOptions SemanticGrpcCoordinate SemanticGrpcCoordinateSequence SemanticGrpcSourceIdentity SemanticGrpcSpatialReference SemanticOdataCompiledQueryV1 SemanticOdataCompileOptions SemanticOdataOutputGeometry SemanticOdataSourceIdentity SemanticOgcApiFeaturesCompiledQueryV1 SemanticOgcApiFeaturesCompileOptions SemanticOgcApiFeaturesSourceIdentity SemanticQueryBuilder SemanticSort SemanticSqlParameter SemanticWfsCompiledQueryV1 SemanticWfsCompileOptions SemanticWfsSourceIdentity StartColumnarWorkerHostOptions Wfs20FilterCapabilitiesEvidence WfsCompiledQueryV1 WfsProtocolCompiledQueryV1 WfsProtocolExecutionQuery WfsProtocolQueryBinding

Type Aliases

AggregateMetric ApacheArrowModuleImporter ApacheArrowModuleLike ApplyColumnarPatchOutcomeV1 BuiltInNativeDialect ColumnarBatchCacheMissReason ColumnarBatchCacheReadV1 ColumnarBatchCacheRefusalReason ColumnarBatchCacheStaleReason ColumnarBatchCacheWriteV1 ColumnarBatchLeaseState ColumnarBufferRole ColumnarGeoJsonGeometry ColumnarGeoJsonGeometryType ColumnarPatchGeometry ColumnarPatchOperationV1 ColumnarPatchRebuildReason ColumnarPatchRejectionCode ColumnarTelemetryKind ColumnarTransferErrorCode ColumnarTransferTarget ColumnarWorkerErrorCode ColumnarWorkerFactory ColumnarWorkerOperation ColumnarWorkerSessionState ColumnarWorkerStreamOrdering ComparisonNode CountMetric Cql2FilterLanguage Cql2JsonExpression DistanceSpatialPredicate DistanceUnit DuckDbGeometryEncoding EqualityOperator ExtremumMetric FieldName GeoArrowAggregateGroupSpec GeoArrowAggregateMetricKind GeoArrowAggregateNullKeyPolicy GeoArrowAggregateNumericColumn GeoArrowAggregateTruncationUnit GeoArrowCoordinateLayout GeoArrowCrs GeoArrowDimensions GeoArrowEdges GeoArrowEnvelopeMigrationPlanV1 GeoArrowEnvelopeMigrationRefusal GeoArrowGeometryColumnInput GeoArrowGeometryKind GeoArrowLineString GeoArrowPoint GeoArrowPolygon GeoArrowPosition GeoArrowTimestampUnit GeometryFieldName GeometryProjectionFor GeoParquetResourceResolver GroupableFieldName GrpcSpatialRelationship GrpcStatisticType HonuaGeoArrowErrorCode LegacyWhereDialectFor LegacyWhereProtocol ListNode NativeDialectFor NativeFilter NativePayloadFor NumericFieldName NumericMetric OdataProtocolModule OrderableFieldName OrderedComparisonOperator OutputCrsFor QueryExecutionPlan QueryFilter QueryLiteral QueryPlanBoundConfidence QueryPlanBoundSource QueryPlanCacheAction QueryPlanCacheFreshness QueryPlanCachePolicy QueryPlanDiscoveryState QueryPlanExecutionFailureReason QueryPlanExecutionMode QueryPlanFidelity QueryPlanRepresentation QueryPlanRepresentationReason QueryPlanRepresentationRequest QueryPlanStepV2 QueryPlanValidatorKind QueryPlanWarningCode RangeNode ScalarFieldName SemanticCompilationResult SemanticCompilerFidelity SemanticCompilerUnsupportedCode SemanticFilter SemanticGeoServicesGeometry SemanticGeoServicesProtocol SemanticGeoServicesSpatialRelationship SemanticGrpcGeometry SemanticGrpcSpatialRelationship SemanticOdataSpatialFunction SemanticPageRequest SemanticQuery SourceSpatiality SpatialityForSchema SpatialNode SpatialPredicate StringFieldName TemporalFieldName TemporalLiteralNode TemporalNode TemporalPredicate TemporalValue TopologicalSpatialPredicate WfsProtocolErrorReason WfsProtocolModule

Variables

COLUMNAR_BATCH_CACHE_CONFORMANCE_CASES COLUMNAR_BATCH_KIND COLUMNAR_BATCH_VERSION COLUMNAR_PATCH_ABORT_CHECK_ROWS COLUMNAR_PATCH_KIND COLUMNAR_PATCH_VERSION COLUMNAR_REPRESENTATION_ENCODINGS COLUMNAR_REPRESENTATION_MIN_BYTES COLUMNAR_REPRESENTATION_MIN_ROWS COLUMNAR_TRANSFER_KIND COLUMNAR_WORKER_CANCEL_KIND COLUMNAR_WORKER_ERROR_KIND COLUMNAR_WORKER_PROGRESS_KIND COLUMNAR_WORKER_PROTOCOL_VERSION COLUMNAR_WORKER_REQUEST_KIND COLUMNAR_WORKER_RESULT_KIND DEFAULT_COLUMNAR_BATCH_CACHE_MAX_AGE_MS DEFAULT_COLUMNAR_BATCH_CACHE_MAX_RECORDS DEFAULT_COLUMNAR_BATCH_CACHE_QUOTA_BYTES DEFAULT_COLUMNAR_BATCH_MAX_BACKING_BYTES DEFAULT_COLUMNAR_BATCH_MAX_BUFFER_VIEWS DEFAULT_COLUMNAR_BATCH_MAX_METADATA_ENTRIES DEFAULT_COLUMNAR_BATCH_MAX_ROWS DEFAULT_COLUMNAR_BATCH_MAX_SCHEMA_NODES DEFAULT_COLUMNAR_BATCH_MAX_STRING_BYTES DEFAULT_COLUMNAR_PATCH_MAX_CAPACITY_UTILIZATION DEFAULT_COLUMNAR_PATCH_MAX_OPERATIONS DEFAULT_COLUMNAR_PATCH_MAX_TOMBSTONE_OVERLAY_BYTES DEFAULT_COLUMNAR_PATCH_MAX_TOMBSTONE_RATIO DEFAULT_COLUMNAR_PATCH_MAX_VERTEX_GROWTH_RATIO DEFAULT_COLUMNAR_RESULT_MAX_FEATURES DEFAULT_GEOARROW_AGGREGATE_MAX_GROUPS DEFAULT_GEOARROW_AGGREGATE_YIELD_ROWS GEOARROW_AGGREGATE_ABORT_CHECK_ROWS GEOARROW_AGGREGATE_MAX_GRID_CELL_INDEX GEOARROW_ENVELOPE_MIGRATIONS GEOARROW_SPEC_VERSION HONUA_COLUMNAR_BATCH_CACHE_CONFORMANCE_KIND HONUA_COLUMNAR_BATCH_CACHE_CONFORMANCE_VERSION HONUA_COLUMNAR_BATCH_CACHE_FORMAT HONUA_COLUMNAR_PATCH_LAYOUT_VERSION HONUA_GEOARROW_AGGREGATE_LAYOUT_VERSION HONUA_GEOARROW_ENVELOPE_KIND HONUA_GEOARROW_ENVELOPE_VERSION HONUA_GEOARROW_LAYOUT_VERSION MAX_COLUMNAR_BATCH_CACHE_MAX_AGE_MS MAX_COLUMNAR_BATCH_CACHE_MAX_RECORDS MAX_COLUMNAR_BATCH_CACHE_QUOTA_BYTES MAX_SEMANTIC_QUERY_BYTES MAX_SEMANTIC_QUERY_COLLECTION_ITEMS MAX_SEMANTIC_QUERY_DEPTH MAX_SEMANTIC_QUERY_NODES MAX_SEMANTIC_QUERY_TEXT_BYTES QUERY_IR_V2_VERSION QUERY_PLAN_DIAGNOSTICS_VERSION QUERY_PLAN_V2_VERSION QUERY_PLANNER_VERSION QUERY_RESOURCE_HANDLE_KIND QUERY_RESOURCE_HANDLE_VERSION SEMANTIC_QUERY_CANONICAL_KIND SEMANTIC_QUERY_CANONICAL_VERSION SEMANTIC_QUERY_HASH_DOMAIN

Functions

applyColumnarPatch canonicalizeQuery canonicalSemanticQueryBytes canonicalStringify columnarAuthorizationScopeDigest columnarBatchCacheFixtureBatch columnarBatchCacheFixtureIdentity columnarBatchCacheKey columnarBatchCacheLegacyEntry columnarBatchCacheOrderingDigest columnarBatchIdentityFromPlan columnarBatchToResult columnarBatchToResultPages columnarPatchLiveMask compileDuckDbQuery compileDuckDbQueryV2 compileGeoServicesQuery compileGrpcQuery compileOdataQuery compileOgcApiFeaturesQuery compileSemanticDuckDbQuery compileSemanticGeoServicesQuery compileSemanticGrpcQuery compileSemanticOdataQuery compileSemanticOgcApiFeaturesQuery compileSemanticWfsQuery compileWfsQuery createColumnarBatch createColumnarBatchCache createColumnarPatch createColumnarPatchOperation createColumnarWorkerSession createGeoArrowAggregateOperation createGeoArrowBatch createGeoArrowReprojectOperation createGeoParquetQueryIr createGeoParquetResourceHandle createGeoParquetResourceRegistry createIndexedDbColumnarBatchCacheStorage createMemoryColumnarBatchCacheStorage createPatchableGeoArrowBatch createQueryIr createQueryPlanRepresentationDecision createSemanticQueryBuilder decodeGeoArrowBatch decodePatchedGeoArrowBatch defineSemanticQuery defineSpatialNode deserializeGeoArrowBatch fromApacheArrowRecordBatch hashGeoParquetResourceHandle hashQueryIr hashSemanticQuery inspectColumnarBatch inspectColumnarPatchState inspectGeoArrowBatch isColumnarRepresentationEncoding leaseColumnarBatch legacyWhereToNativeFilter loadApacheArrow migrateGeoParquetQueryPlanV1 odataProtocolModule parseGeoParquetResourceHandle parseQueryPlan parseSemanticQuery planColumnarBatchCacheAdmission planGeoArrowEnvelopeMigration queryFromCanonical queryPlanCacheKey readableGeoArrowEnvelopeVersions readGeoArrowAggregateBatch resolveGeoParquetResource resultToColumnarBatch runColumnarBatchCacheConformance semanticFilterFromCql2Json semanticFilterToCql2Json serializeCanonicalSemanticQuery serializeGeoArrowBatch serializeQueryPlan sha256 startColumnarWorkerHost temporalLiteral toApacheArrowRecordBatch toJsonValue wfsProtocolModule

References

Re-exports CanonicalQuery
Re-exports CanonicalSpatialFilter
Re-exports executeQueryPlan
Re-exports ExecuteQueryPlanOptions
Re-exports explainQuery
Re-exports ExplainQueryOptions
Re-exports hashQueryPlan
Re-exports HonuaQueryPlanExecutionError
Re-exports HonuaQueryPlanningError
Re-exports JsonPrimitive
Re-exports JsonValue
Re-exports LocalAggregatePlanStep
Re-exports MAX_LOCAL_MATERIALIZATION_ROWS
Re-exports QUERY_IR_KIND
Re-exports QUERY_IR_VERSION
Re-exports QUERY_PLAN_KIND
Re-exports QUERY_PLAN_VERSION
Re-exports QueryExecutionPlanV1
Re-exports QueryFallbackPolicy
Re-exports QueryIrSourceIdentity
Re-exports QueryIrV1
Re-exports QueryPlanExecution
Re-exports QueryPlanExecutionErrorCode
Re-exports QueryPlanExecutor
Re-exports QueryPlanningErrorCode
Re-exports QueryPlanningEstimates
Re-exports QueryPlanStep
Re-exports RemoteCompiledQueryV1
Re-exports RemoteQueryPlanStep