flatsql 3.11.1 → 3.12.0

package/sdm/index.js

@@ -1,253 +0,0 @@
-/**
- * FlatSQL Spatial Engine — Space Data Module (SDM)
- *
- * Standalone WASM module compliant with space-data-module-sdk.
- * Provides spatial computation functions without requiring full FlatSQL.
- *
- * @see https://github.com/DigitalArsenal/space-data-module-sdk
- */
-
-import { readFile } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/**
- * Initialize the FlatSQL Spatial SDM module.
- * @returns {Promise<FlatSQLSpatialSDM>}
- */
-export async function initSpatialSDM() {
-  const wasmPath = join(__dirname, "flatsql-spatial.wasm");
-  const wasmBytes = await readFile(wasmPath);
-  let exports;
-  const invoke = () => (fnPtr, ...args) => {
-    const table = exports?.__indirect_function_table;
-    const fn = table?.get(fnPtr);
-    if (typeof fn !== "function") {
-      throw new Error(`Missing indirect WASM function: ${fnPtr}`);
-    }
-    return fn(...args);
-  };
-  const { instance } = await WebAssembly.instantiate(wasmBytes, {
-    env: {
-      invoke_v: invoke("v"),
-      invoke_i: invoke("i"),
-      invoke_ii: invoke("ii"),
-      invoke_iii: invoke("iii"),
-      invoke_iiii: invoke("iiii"),
-      invoke_iiiii: invoke("iiiii"),
-      invoke_iiiiii: invoke("iiiiii"),
-      invoke_iiiiiii: invoke("iiiiiii"),
-      invoke_iiiiiiii: invoke("iiiiiiii"),
-      invoke_iiiiiiiiiiii: invoke("iiiiiiiiiiii"),
-      invoke_iiiiid: invoke("iiiiid"),
-      invoke_di: invoke("di"),
-      invoke_dii: invoke("dii"),
-      invoke_diii: invoke("diii"),
-      invoke_fiii: invoke("fiii"),
-      invoke_iid: invoke("iid"),
-      invoke_jiiii: invoke("jiiii"),
-      invoke_vi: invoke("vi"),
-      invoke_vid: invoke("vid"),
-      invoke_vii: invoke("vii"),
-      invoke_viii: invoke("viii"),
-      invoke_viiii: invoke("viiii"),
-      invoke_viiiii: invoke("viiiii"),
-      invoke_viiiiiii: invoke("viiiiiii"),
-      invoke_viiiiiiiiii: invoke("viiiiiiiiii"),
-      invoke_viiiiiiiiiiiiiii: invoke("viiiiiiiiiiiiiii"),
-      __cxa_begin_catch: (ptr) => ptr,
-      __cxa_end_catch: () => {},
-      __cxa_find_matching_catch_2: () => 0,
-      __cxa_find_matching_catch_3: () => 0,
-      __cxa_rethrow: () => {},
-      __cxa_throw: () => {},
-      __cxa_uncaught_exceptions: () => 0,
-      __resumeException: (ptr) => {
-        throw new Error(`Unhandled WASM exception: ${ptr}`);
-      },
-      emscripten_notify_memory_growth: () => {},
-    },
-    wasi_snapshot_preview1: {
-      environ_get: () => 0,
-      environ_sizes_get: (environCount, environBufSize) => {
-        const memory = exports?.memory;
-        if (memory) {
-          const view = new DataView(memory.buffer);
-          view.setUint32(environCount, 0, true);
-          view.setUint32(environBufSize, 0, true);
-        }
-        return 0;
-      },
-      proc_exit: () => {},
-      fd_write: () => 0,
-      fd_seek: () => 0,
-      fd_close: () => 0,
-    },
-  });
-  exports = instance.exports;
-  const memory = /** @type {WebAssembly.Memory} */ (exports.memory);
-
-  /**
-   * Write a string to the input buffer.
-   * @param {string} str
-   */
-  function writeInput(str) {
-    const inputPtr = /** @type {Function} */ (exports.sdm_get_input_buffer)();
-    const encoder = new TextEncoder();
-    const bytes = encoder.encode(str);
-    const view = new Uint8Array(memory.buffer, inputPtr, bytes.length);
-    view.set(bytes);
-    /** @type {Function} */ (exports.sdm_set_input_length)(bytes.length);
-  }
-
-  /**
-   * Read the output buffer as a string.
-   * @returns {string}
-   */
-  function readOutput() {
-    const outputLen = /** @type {Function} */ (exports.sdm_get_output_length)();
-    const outputPtr = /** @type {Function} */ (exports.sdm_get_output_buffer)();
-    const view = new Uint8Array(memory.buffer, outputPtr, outputLen);
-    return new TextDecoder().decode(view);
-  }
-
-  /**
-   * Call a method with string input, return string output.
-   * @param {string} methodName
-   * @param {string} input
-   * @returns {{ status: number, output: string }}
-   */
-  function callMethod(methodName, input) {
-    writeInput(input);
-    const fn = exports[methodName];
-    if (!fn) throw new Error(`Unknown method: ${methodName}`);
-    const status = /** @type {Function} */ (fn)();
-    return { status, output: readOutput() };
-  }
-
-  /**
-   * Get the embedded plugin manifest.
-   * @returns {object}
-   */
-  function getManifest() {
-    const ptr = /** @type {Function} */ (exports.plugin_get_manifest)();
-    const size = /** @type {Function} */ (exports.plugin_get_manifest_size)();
-    const view = new Uint8Array(memory.buffer, ptr, size);
-    const text = new TextDecoder().decode(view);
-    return JSON.parse(text);
-  }
-
-  return {
-    /** Get the plugin manifest */
-    getManifest,
-
-    /**
-     * Compute haversine distance between two points.
-     * @param {number} lat1 @param {number} lon1
-     * @param {number} lat2 @param {number} lon2
-     * @returns {number} distance in km
-     */
-    computeDistance(lat1, lon1, lat2, lon2) {
-      const { status, output } = callMethod("compute_distance", `${lat1},${lon1},${lat2},${lon2}`);
-      if (status !== 0) throw new Error(output);
-      return parseFloat(output);
-    },
-
-    /**
-     * Compute bearing from point 1 to point 2.
-     * @param {number} lat1 @param {number} lon1
-     * @param {number} lat2 @param {number} lon2
-     * @returns {number} bearing in degrees (0-360)
-     */
-    computeBearing(lat1, lon1, lat2, lon2) {
-      const { status, output } = callMethod("compute_bearing", `${lat1},${lon1},${lat2},${lon2}`);
-      if (status !== 0) throw new Error(output);
-      return parseFloat(output);
-    },
-
-    /**
-     * Test if a point is inside a polygon.
-     * @param {string} wkt - WKT polygon
-     * @param {number} lat @param {number} lon
-     * @returns {boolean}
-     */
-    pointInPolygon(wkt, lat, lon) {
-      const { status, output } = callMethod("point_in_polygon", `${wkt}\n${lat},${lon}`);
-      if (status !== 0) throw new Error(output);
-      return output === "1";
-    },
-
-    /**
-     * Compute polygon intersection.
-     * @param {string} wkt1 @param {string} wkt2
-     * @returns {string} WKT of intersection
-     */
-    polygonIntersection(wkt1, wkt2) {
-      const { status, output } = callMethod("polygon_intersection", `${wkt1}\n${wkt2}`);
-      if (status !== 0) throw new Error(output);
-      return output;
-    },
-
-    /**
-     * Compute polygon union.
-     * @param {string} wkt1 @param {string} wkt2
-     * @returns {string} WKT of union
-     */
-    polygonUnion(wkt1, wkt2) {
-      const { status, output } = callMethod("polygon_union", `${wkt1}\n${wkt2}`);
-      if (status !== 0) throw new Error(output);
-      return output;
-    },
-
-    /**
-     * Compute Voronoi diagram.
-     * @param {string} multipointWkt @param {string} boundsWkt
-     * @returns {string} MULTIPOLYGON WKT
-     */
-    computeVoronoi(multipointWkt, boundsWkt) {
-      const { status, output } = callMethod("compute_voronoi", `${multipointWkt}\n${boundsWkt}`);
-      if (status !== 0) throw new Error(output);
-      return output;
-    },
-
-    /**
-     * Compute Delaunay triangulation.
-     * @param {string} multipointWkt
-     * @returns {string} MULTIPOLYGON WKT
-     */
-    computeDelaunay(multipointWkt) {
-      const { status, output } = callMethod("compute_delaunay", multipointWkt);
-      if (status !== 0) throw new Error(output);
-      return output;
-    },
-
-    /**
-     * Transform WGS84 to ECEF.
-     * @param {number} lat @param {number} lon @param {number} alt
-     * @returns {{ x: number, y: number, z: number }}
-     */
-    toECEF(lat, lon, alt) {
-      const { status, output } = callMethod("transform_to_ecef", `${lat},${lon},${alt}`);
-      if (status !== 0) throw new Error(output);
-      const [x, y, z] = output.split(",").map(Number);
-      return { x, y, z };
-    },
-
-    /**
-     * Transform ECEF to WGS84.
-     * @param {number} x @param {number} y @param {number} z
-     * @returns {{ lat: number, lon: number, alt: number }}
-     */
-    fromECEF(x, y, z) {
-      const { status, output } = callMethod("transform_from_ecef", `${x},${y},${z}`);
-      if (status !== 0) throw new Error(output);
-      const [lat, lon, alt] = output.split(",").map(Number);
-      return { lat, lon, alt };
-    },
-
-    /** Low-level method call */
-    callMethod,
-  };
-}

package/sdm/manifest.json

@@ -1,402 +0,0 @@
-{
-  "pluginId": "com.digitalarsenal.flatsql.spatial",
-  "name": "FlatSQL Spatial Engine",
-  "version": "0.4.1",
-  "pluginFamily": "analysis",
-  "description": "SpatiaLite-compatible spatial computation engine for space data processing. Provides geodesic calculations, polygon boolean operations, Voronoi/Delaunay tessellation, coordinate transforms, and R-Tree spatial indexing over FlatBuffer storage.",
-  "capabilities": [],
-  "externalInterfaces": [],
-  "methods": [
-    {
-      "methodId": "compute_distance",
-      "displayName": "Compute Distance",
-      "description": "Haversine distance between two WGS84 lat/lon points (km)",
-      "inputPorts": [
-        {
-          "portId": "coordinates",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 1000,
-      "drainPolicy": "drain-to-empty"
-    },
-    {
-      "methodId": "compute_bearing",
-      "displayName": "Compute Bearing",
-      "description": "Forward azimuth between two WGS84 points (degrees 0-360)",
-      "inputPorts": [
-        {
-          "portId": "coordinates",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 1000,
-      "drainPolicy": "drain-to-empty"
-    },
-    {
-      "methodId": "point_in_polygon",
-      "displayName": "Point in Polygon",
-      "description": "Test if a WGS84 point is inside a polygon geometry",
-      "inputPorts": [
-        {
-          "portId": "geometry",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 1000,
-      "drainPolicy": "drain-to-empty"
-    },
-    {
-      "methodId": "polygon_intersection",
-      "displayName": "Polygon Intersection",
-      "description": "Compute intersection of two polygon geometries",
-      "inputPorts": [
-        {
-          "portId": "geometries",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 2,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 100,
-      "drainPolicy": "drain-to-empty"
-    },
-    {
-      "methodId": "polygon_union",
-      "displayName": "Polygon Union",
-      "description": "Compute union of two polygon geometries",
-      "inputPorts": [
-        {
-          "portId": "geometries",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 2,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 100,
-      "drainPolicy": "drain-to-empty"
-    },
-    {
-      "methodId": "compute_voronoi",
-      "displayName": "Voronoi Diagram",
-      "description": "Compute Voronoi diagram from multipoint geometry within bounds",
-      "inputPorts": [
-        {
-          "portId": "geometries",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 2,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 10,
-      "drainPolicy": "single-shot"
-    },
-    {
-      "methodId": "compute_delaunay",
-      "displayName": "Delaunay Triangulation",
-      "description": "Compute Delaunay triangulation from multipoint geometry",
-      "inputPorts": [
-        {
-          "portId": "geometries",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 10,
-      "drainPolicy": "single-shot"
-    },
-    {
-      "methodId": "transform_to_ecef",
-      "displayName": "WGS84 to ECEF",
-      "description": "Transform WGS84 geodetic coordinates to ECEF",
-      "inputPorts": [
-        {
-          "portId": "coordinates",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 10000,
-      "drainPolicy": "drain-to-empty"
-    },
-    {
-      "methodId": "transform_from_ecef",
-      "displayName": "ECEF to WGS84",
-      "description": "Transform ECEF coordinates to WGS84 geodetic",
-      "inputPorts": [
-        {
-          "portId": "coordinates",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 10000,
-      "drainPolicy": "drain-to-empty"
-    },
-    {
-      "methodId": "spatial_query",
-      "displayName": "Spatial SQL Query",
-      "description": "Execute an arbitrary spatial SQL query using the FlatSQL engine",
-      "inputPorts": [
-        {
-          "portId": "query",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialQuery.fbs", "fileIdentifier": "SPQR" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "outputPorts": [
-        {
-          "portId": "result",
-          "acceptedTypeSets": [
-            {
-              "setId": "spatial",
-              "allowedTypes": [
-                { "schemaName": "SpatialResult.fbs", "fileIdentifier": "SPRS" }
-              ]
-            }
-          ],
-          "minStreams": 1,
-          "maxStreams": 1,
-          "required": true
-        }
-      ],
-      "maxBatch": 1,
-      "drainPolicy": "single-shot"
-    }
-  ],
-  "runtimeTargets": ["NODE", "BROWSER", "WASI"]
-}

package/stress/docker/Dockerfile

@@ -1,11 +0,0 @@
-FROM node:24-bookworm-slim
-
-WORKDIR /workspace
-
-COPY package.json package-lock.json ./
-RUN npm ci
-
-COPY . .
-RUN npm run build
-
-CMD ["node", "stress/sds/run.mjs", "--help"]