@honua/sdk-esri-compat 0.1.12 → 0.1.13

package/query-planner/semantic.d.ts

@@ -0,0 +1,54 @@
+import { type JsonValue, type SourceProtocol } from "../contract/schema.js";
+import type { AggregateMetric, ComparisonNode, EqualityOperator, FieldName, GeometryProjectionFor, GroupableFieldName, LiteralNode, NativeDialectFor, NativeFilter, NullNode, OrderableFieldName, OrderedComparisonOperator, ParseSemanticQueryOptions, PatternNode, PropertyNode, QueryLiteral, RangeNode, ScalarFieldName, SemanticAggregateQuery, SemanticFeatureQuery, SemanticFilter, SemanticQuery, SourceSpatiality, SpatialNode, StringFieldName, TemporalFieldName, TemporalLiteralNode, TemporalNode, TemporalPredicate } from "./semantic-types.js";
+export declare const MAX_SEMANTIC_QUERY_BYTES: number;
+export declare const MAX_SEMANTIC_QUERY_DEPTH = 64;
+export declare const MAX_SEMANTIC_QUERY_NODES = 20000;
+export declare const MAX_SEMANTIC_QUERY_COLLECTION_ITEMS = 10000;
+export declare const MAX_SEMANTIC_QUERY_TEXT_BYTES: number;
+type RuntimeQuery = SemanticQuery<Record<string, unknown>, SourceProtocol, SourceSpatiality>;
+/** @internal Shared bounded JSON boundary for semantic interchange codecs. */
+export declare function parseBoundedSemanticJson(value: string | unknown): JsonValue;
+/**
+ * Parse untrusted JSON or an untyped JavaScript value into a deeply immutable
+ * semantic query. Syntax, resource bounds, dialect payload shape, and (when
+ * supplied) schema field/type compatibility are all checked before return.
+ */
+export declare function parseSemanticQuery(value: string | unknown, options?: ParseSemanticQueryOptions): RuntimeQuery;
+/** Validate and freeze a typed query while preserving its generic relationship. */
+export declare function defineSemanticQuery<const TQuery extends {
+    readonly kind: "features" | "aggregate";
+}>(query: TQuery, options?: ParseSemanticQueryOptions): TQuery;
+export interface SemanticQueryBuilder<TRecord, TProtocol extends SourceProtocol, TSpatiality extends SourceSpatiality> {
+    property<TKey extends FieldName<TRecord>>(name: TKey): PropertyNode<TKey>;
+    literal<const TValue extends JsonValue>(value: TValue): LiteralNode<TValue>;
+    comparison<TKey extends ScalarFieldName<TRecord>>(operator: EqualityOperator, left: PropertyNode<TKey>, right: QueryLiteral<TRecord[TKey]> | LiteralNode<QueryLiteral<TRecord[TKey]>>): ComparisonNode<TRecord>;
+    comparison<TKey extends OrderableFieldName<TRecord>>(operator: OrderedComparisonOperator, left: PropertyNode<TKey>, right: QueryLiteral<TRecord[TKey]> | LiteralNode<QueryLiteral<TRecord[TKey]>>): ComparisonNode<TRecord>;
+    inList<TKey extends ScalarFieldName<TRecord>>(operand: PropertyNode<TKey>, values: readonly [
+        QueryLiteral<TRecord[TKey]> | LiteralNode<QueryLiteral<TRecord[TKey]>>,
+        ...(QueryLiteral<TRecord[TKey]> | LiteralNode<QueryLiteral<TRecord[TKey]>>)[]
+    ]): SemanticFilter<TRecord, TSpatiality>;
+    between<TKey extends OrderableFieldName<TRecord>>(operand: PropertyNode<TKey>, lower: QueryLiteral<TRecord[TKey]> | LiteralNode<QueryLiteral<TRecord[TKey]>>, upper: QueryLiteral<TRecord[TKey]> | LiteralNode<QueryLiteral<TRecord[TKey]>>): RangeNode<TRecord>;
+    isNull<TKey extends FieldName<TRecord>>(operand: PropertyNode<TKey>, operator?: "is-null" | "is-not-null"): NullNode<TKey>;
+    like<TKey extends StringFieldName<TRecord>>(operand: PropertyNode<TKey>, pattern: string, options?: {
+        readonly caseSensitive?: boolean;
+    }): PatternNode<TKey>;
+    and(...args: readonly [SemanticFilter<TRecord, TSpatiality>, ...SemanticFilter<TRecord, TSpatiality>[]]): SemanticFilter<TRecord, TSpatiality>;
+    or(...args: readonly [SemanticFilter<TRecord, TSpatiality>, ...SemanticFilter<TRecord, TSpatiality>[]]): SemanticFilter<TRecord, TSpatiality>;
+    not(arg: SemanticFilter<TRecord, TSpatiality>): SemanticFilter<TRecord, TSpatiality>;
+    temporal<TKey extends TemporalFieldName<TRecord>>(operator: TemporalPredicate, operand: PropertyNode<TKey>, value: TemporalLiteralNode): TemporalNode<TRecord>;
+    native<TDialect extends NativeDialectFor<TProtocol>>(dialect: TDialect, payload: NativeFilter<TDialect>["payload"]): NativeFilter<TDialect>;
+    features<const TSelect extends readonly FieldName<TRecord>[] | undefined = undefined, const TGeometry extends GeometryProjectionFor<TRecord, TSpatiality> = GeometryProjectionFor<TRecord, TSpatiality>>(query?: Omit<SemanticFeatureQuery<TRecord, TProtocol, TSpatiality, TSelect, TGeometry>, "kind">): SemanticFeatureQuery<TRecord, TProtocol, TSpatiality, TSelect, TGeometry>;
+    aggregate<const TGroupBy extends readonly GroupableFieldName<TRecord>[], const TMetrics extends readonly [AggregateMetric<TRecord>, ...AggregateMetric<TRecord>[]]>(query: Omit<SemanticAggregateQuery<TRecord, TProtocol, TSpatiality, TGroupBy, TMetrics>, "kind">): SemanticAggregateQuery<TRecord, TProtocol, TSpatiality, TGroupBy, TMetrics>;
+}
+/** Create immutable, schema-typed AST nodes without importing a protocol compiler. */
+export declare function createSemanticQueryBuilder<TRecord, TProtocol extends SourceProtocol, TSpatiality extends SourceSpatiality = "ambiguous-geometry">(): SemanticQueryBuilder<TRecord, TProtocol, TSpatiality>;
+/** Build a validated spatial node without weakening its executable operand. */
+export declare function defineSpatialNode<TRecord, TSpatiality extends Exclude<SourceSpatiality, "non-spatial">>(value: SpatialNode<TRecord, TSpatiality>): SpatialNode<TRecord, TSpatiality>;
+export declare function temporalLiteral(valueType: "date" | "instant", value: string): Extract<TemporalLiteralNode, {
+    readonly valueType: "date" | "instant";
+}>;
+export declare function temporalLiteral(valueType: "interval", value: readonly [string, string]): Extract<TemporalLiteralNode, {
+    readonly valueType: "interval";
+}>;
+export {};
+//# sourceMappingURL=semantic.d.ts.map

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

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