@honua/react 0.0.20-alpha.0 → 0.1.1-beta.0

package/query-planner/grpc.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Compile canonical query IR to a deterministic, inspectable description of the
+ * `honua.v1.FeatureService/QueryFeatures` unary gRPC request — without pulling
+ * the `@bufbuild/protobuf` runtime into the planner graph.
+ *
+ * The compiled object mirrors the generated `QueryFeaturesRequest` message
+ * field-for-field (including proto enum *value names* for spatial relationship
+ * and statistic type), so it is a faithful, hashable pre-image of the wire
+ * request. The live gRPC adapter (`core/grpc-adapter.ts`) turns the same
+ * canonical inputs into the protobuf message; this keeps the plan honest about
+ * exactly what will be sent.
+ *
+ * @module
+ */
+import type { ExecutableCrsBinding, SourceSchemaV2 } from "../contract/schema.js";
+import { type SemanticCompilationResult } from "./semantic-compiler.js";
+import type { SemanticQuery, SourceSpatiality } from "./semantic-types.js";
+import type { CanonicalQuery, GrpcCompiledQueryV1, GrpcSpatialRelationship, GrpcStatisticType, QueryIrSourceIdentity } from "./types.js";
+/** Credential-free source locator fields needed by QueryFeatures. */
+export interface SemanticGrpcSourceIdentity {
+    readonly serviceId: string;
+    readonly layerId: number;
+}
+export interface SemanticGrpcCompileOptions<TRecord = Record<string, unknown>, TSpatiality extends SourceSpatiality = SourceSpatiality> {
+    readonly query: SemanticQuery<TRecord, "grpc", TSpatiality>;
+    readonly schema: SourceSchemaV2;
+    readonly source: SemanticGrpcSourceIdentity;
+}
+export interface SemanticGrpcSpatialReference {
+    readonly wkid?: number;
+    readonly wkt?: string;
+}
+export interface SemanticGrpcCoordinate {
+    readonly x: number;
+    readonly y: number;
+    readonly z?: number;
+}
+export interface SemanticGrpcCoordinateSequence {
+    readonly coords: readonly SemanticGrpcCoordinate[];
+}
+/** Protobuf-free JSON pre-image of honua.v1.Geometry. */
+export type SemanticGrpcGeometry = {
+    readonly point: SemanticGrpcCoordinate;
+} | {
+    readonly multiPoint: {
+        readonly points: readonly SemanticGrpcCoordinate[];
+    };
+} | {
+    readonly polyline: {
+        readonly paths: readonly SemanticGrpcCoordinateSequence[];
+    };
+} | {
+    readonly polygon: {
+        readonly rings: readonly SemanticGrpcCoordinateSequence[];
+    };
+} | {
+    readonly multiPolygon: {
+        readonly polygons: readonly {
+            readonly rings: readonly SemanticGrpcCoordinateSequence[];
+        }[];
+    };
+};
+export type SemanticGrpcSpatialRelationship = GrpcSpatialRelationship | "SPATIAL_RELATIONSHIP_EQUALS";
+/** Canonical, protobuf-runtime-free QueryFeatures request artifact. */
+export interface SemanticGrpcCompiledQueryV1 {
+    readonly compiler: "honua-grpc-semantic-query-v1";
+    readonly dialect: "honua-grpc";
+    readonly schemaFingerprint: SourceSchemaV2["fingerprint"];
+    readonly queryFingerprint: `sha256:${string}`;
+    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?: SemanticGrpcSpatialReference;
+    readonly orderBy?: string;
+    readonly resultOffset?: number;
+    readonly resultRecordCount?: number;
+    readonly spatialFilter?: {
+        readonly geometry: SemanticGrpcGeometry;
+        readonly spatialRelationship: SemanticGrpcSpatialRelationship;
+        readonly spatialReference: SemanticGrpcSpatialReference;
+        /** Full executable binding retained beside the protobuf spatial reference. */
+        readonly crs: ExecutableCrsBinding;
+    };
+    readonly outStatistics?: readonly {
+        readonly statisticType: GrpcStatisticType;
+        readonly onStatisticField: string;
+        readonly outStatisticFieldName: string;
+    }[];
+    readonly groupBy?: readonly string[];
+    readonly usesNativeFilter: boolean;
+}
+/** Compile canonical query IR to the Honua gRPC `QueryFeatures` request shape. */
+export declare function compileGrpcQuery(source: QueryIrSourceIdentity, query: CanonicalQuery): GrpcCompiledQueryV1;
+/** Compile a typed semantic query to the canonical QueryFeatures request shape. */
+export declare function compileSemanticGrpcQuery<TRecord, TSpatiality extends SourceSpatiality>(options: SemanticGrpcCompileOptions<TRecord, TSpatiality>): SemanticCompilationResult<SemanticGrpcCompiledQueryV1>;
+//# sourceMappingURL=grpc.d.ts.map

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

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