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

package/query-planner/local-aggregate.js

@@ -0,0 +1,126 @@
+import { HonuaAbortError } from "../core/errors.js";
+export function aggregateLocally(features, aggregation, output, signal) {
+    throwIfLocalAggregationAborted(signal);
+    const groupKeys = aggregation.groupBy ?? [];
+    const rows = groupKeys.length === 0
+        ? [computeMetrics(features, aggregation.metrics, signal)]
+        : aggregateGroups(features, groupKeys, aggregation.metrics, signal);
+    throwIfLocalAggregationAborted(signal);
+    const ordered = output.orderBy && output.orderBy.length > 0 ? [...rows].sort(rowComparator(output.orderBy, signal)) : rows;
+    throwIfLocalAggregationAborted(signal);
+    const offset = output.pagination?.offset ?? 0;
+    const limit = output.pagination?.limit;
+    return limit === undefined ? ordered.slice(offset) : ordered.slice(offset, offset + limit);
+}
+function aggregateGroups(features, groupKeys, metrics, signal) {
+    const groups = new Map();
+    for (let index = 0; index < features.length; index += 1) {
+        if ((index & 255) === 0)
+            throwIfLocalAggregationAborted(signal);
+        const feature = features[index];
+        if (!feature)
+            continue;
+        const key = JSON.stringify(groupKeys.map((field) => readField(feature.attributes, field)));
+        const bucket = groups.get(key);
+        if (bucket)
+            bucket.push(feature);
+        else
+            groups.set(key, [feature]);
+    }
+    return Array.from(groups.values(), (bucket, index) => {
+        if ((index & 255) === 0)
+            throwIfLocalAggregationAborted(signal);
+        const row = {};
+        for (const field of groupKeys)
+            row[field] = readField(bucket[0]?.attributes, field);
+        return Object.assign(row, computeMetrics(bucket, metrics, signal));
+    });
+}
+function computeMetrics(features, metrics, signal) {
+    const output = {};
+    for (let metricIndex = 0; metricIndex < metrics.length; metricIndex += 1) {
+        throwIfLocalAggregationAborted(signal);
+        const metric = metrics[metricIndex];
+        if (!metric)
+            continue;
+        const alias = metric.alias ?? `${metric.fn}_${metric.field}`;
+        const values = [];
+        for (let featureIndex = 0; featureIndex < features.length; featureIndex += 1) {
+            if ((featureIndex & 255) === 0)
+                throwIfLocalAggregationAborted(signal);
+            const feature = features[featureIndex];
+            if (!feature)
+                continue;
+            const value = readField(feature.attributes, metric.field);
+            if (typeof value === "number" && Number.isFinite(value))
+                values.push(value);
+        }
+        output[alias] = applyAggregation(metric.fn, values, features.length);
+    }
+    return output;
+}
+function applyAggregation(fn, values, totalRows) {
+    if (fn === "count")
+        return totalRows;
+    if (values.length === 0)
+        return 0;
+    switch (fn) {
+        case "sum":
+            return values.reduce((sum, value) => sum + value, 0);
+        case "avg":
+            return values.reduce((sum, value) => sum + value, 0) / values.length;
+        case "min":
+            return Math.min(...values);
+        case "max":
+            return Math.max(...values);
+        case "stddev":
+        case "var": {
+            const mean = values.reduce((sum, value) => sum + value, 0) / values.length;
+            const variance = values.reduce((sum, value) => sum + (value - mean) ** 2, 0) / values.length;
+            return fn === "var" ? variance : Math.sqrt(variance);
+        }
+    }
+}
+function rowComparator(orderBy, signal) {
+    let comparisons = 0;
+    return (left, right) => {
+        comparisons += 1;
+        if ((comparisons & 255) === 0)
+            throwIfLocalAggregationAborted(signal);
+        for (const sort of orderBy) {
+            const comparison = compareValues(left[sort.field], right[sort.field]);
+            if (comparison !== 0)
+                return sort.direction === "desc" ? -comparison : comparison;
+        }
+        return 0;
+    };
+}
+function throwIfLocalAggregationAborted(signal) {
+    if (!signal)
+        return;
+    try {
+        if (signal.aborted)
+            throw new HonuaAbortError();
+    }
+    catch (error) {
+        if (error instanceof HonuaAbortError)
+            throw error;
+        throw new HonuaAbortError();
+    }
+}
+function compareValues(left, right) {
+    if (left === right)
+        return 0;
+    if (left === null || left === undefined)
+        return -1;
+    if (right === null || right === undefined)
+        return 1;
+    if (typeof left === "number" && typeof right === "number")
+        return left - right;
+    return String(left).localeCompare(String(right));
+}
+function readField(attributes, field) {
+    if (attributes === null || typeof attributes !== "object")
+        return undefined;
+    return attributes[field];
+}

package/query-planner/odata.d.ts

@@ -0,0 +1,48 @@
+import type { ExecutableCrsBinding, SourceSchemaV2 } from "../contract/schema.js";
+import { type SemanticCompilationResult } from "./semantic-compiler.js";
+import { type SemanticCompilerFieldMapping } from "./semantic-literals.js";
+import type { SemanticQuery, SourceSpatiality } from "./semantic-types.js";
+import type { CanonicalQuery, OdataCompiledQueryV1, QueryIrSourceIdentity } from "./types.js";
+/** Compile canonical query IR to a deterministic OData v4 entity-set request. */
+export declare function compileOdataQuery(source: QueryIrSourceIdentity, query: CanonicalQuery): OdataCompiledQueryV1;
+export type SemanticOdataSpatialFunction = "geo.intersects" | "geo.distance";
+/** Static, credential-free OData endpoint evidence used by the semantic compiler. */
+export interface SemanticOdataSourceIdentity {
+    readonly entitySet: string;
+    readonly sourceVersion?: string;
+    /** Spatial functions explicitly advertised or certified for this service. */
+    readonly supportedSpatialFunctions?: readonly SemanticOdataSpatialFunction[];
+}
+export interface SemanticOdataCompileOptions<TRecord = Record<string, unknown>, TSpatiality extends SourceSpatiality = SourceSpatiality> {
+    readonly query: SemanticQuery<TRecord, "odata", TSpatiality>;
+    readonly schema: SourceSchemaV2;
+    readonly source: SemanticOdataSourceIdentity;
+}
+export interface SemanticOdataOutputGeometry {
+    readonly field: string;
+    readonly propertyPath: string;
+    readonly spatialType: "geography" | "geometry";
+    readonly crs: ExecutableCrsBinding;
+    readonly layout: "xy";
+}
+/** Canonical pre-image of an OData v4 entity-set request. */
+export interface SemanticOdataCompiledQueryV1 {
+    readonly compiler: "odata-v4-semantic-query-v1";
+    readonly dialect: "odata-4.0";
+    readonly schemaFingerprint: SourceSchemaV2["fingerprint"];
+    readonly queryFingerprint: `sha256:${string}`;
+    readonly requestFingerprint: `sha256:${string}`;
+    readonly entitySet: string;
+    readonly sourceVersion?: string;
+    readonly filter?: string;
+    readonly select: readonly string[];
+    readonly orderBy?: readonly string[];
+    readonly skip?: number;
+    readonly top?: number;
+    readonly outputGeometry?: SemanticOdataOutputGeometry;
+    readonly fieldMappings: readonly SemanticCompilerFieldMapping[];
+    readonly usesNativeFilter: boolean;
+}
+/** Compile a validated semantic AST to exact OData v4 system query options. */
+export declare function compileSemanticOdataQuery<TRecord, TSpatiality extends SourceSpatiality>(options: SemanticOdataCompileOptions<TRecord, TSpatiality>): SemanticCompilationResult<SemanticOdataCompiledQueryV1>;
+//# sourceMappingURL=odata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"odata.d.ts","sourceRoot":"","sources":["../../../src/query-planner/odata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAGV,oBAAoB,EAOpB,cAAc,EACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAEL,KAAK,yBAAyB,EAO/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,4BAA4B,EAWlC,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAe,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAG9F,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,cAAc,GAAG,oBAAoB,CAoF5G;AAmFD,MAAM,MAAM,4BAA4B,GAAG,gBAAgB,GAAG,cAAc,CAAC;AAE7E,qFAAqF;AACrF,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,6EAA6E;IAC7E,QAAQ,CAAC,yBAAyB,CAAC,EAAE,SAAS,4BAA4B,EAAE,CAAC;CAC9E;AAED,MAAM,WAAW,2BAA2B,CAC1C,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,WAAW,SAAS,gBAAgB,GAAG,gBAAgB;IAEvD,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC7D,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,WAAW,GAAG,UAAU,CAAC;IAC/C,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;CACvB;AAED,6DAA6D;AAC7D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,4BAA4B,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;IAC1D,QAAQ,CAAC,gBAAgB,EAAE,UAAU,MAAM,EAAE,CAAC;IAC9C,QAAQ,CAAC,kBAAkB,EAAE,UAAU,MAAM,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,cAAc,CAAC,EAAE,2BAA2B,CAAC;IACtD,QAAQ,CAAC,aAAa,EAAE,SAAS,4BAA4B,EAAE,CAAC;IAChE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;CACpC;AA0BD,+EAA+E;AAC/E,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,WAAW,SAAS,gBAAgB,EACrF,OAAO,EAAE,2BAA2B,CAAC,OAAO,EAAE,WAAW,CAAC,GACzD,yBAAyB,CAAC,4BAA4B,CAAC,CA4CzD"}