squirreling 0.9.2 → 0.9.3

package/README.md

@@ -149,6 +149,8 @@ Squirreling mostly follows the SQL standard. The following features are supporte
 - Trig: `SIN`, `COS`, `TAN`, `COT`, `ASIN`, `ACOS`, `ATAN`, `ATAN2`, `DEGREES`, `RADIANS`, `PI`
 - Date: `CURRENT_DATE`, `CURRENT_TIME`, `CURRENT_TIMESTAMP`, `INTERVAL`
 - Json: `JSON_VALUE`, `JSON_QUERY`, `JSON_OBJECT`
+- Array: `ARRAY_LENGTH`, `ARRAY_POSITION`, `ARRAY_SORT`, `CARDINALITY`
 - Regex: `REGEXP_SUBSTR`, `REGEXP_REPLACE`
+- Spatial: `ST_GeomFromText`, `ST_MakeEnvelope`, `ST_AsText`, `ST_Intersects`, `ST_Contains`, `ST_ContainsProperly`, `ST_Within`, `ST_Overlaps`, `ST_Touches`, `ST_Equals`, `ST_Crosses`, `ST_Covers`, `ST_CoveredBy`, `ST_DWithin`
 - Conditional: `COALESCE`, `NULLIF`
 - User-defined functions (UDFs)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squirreling",
-  "version": "0.9.2",
+  "version": "0.9.3",
   "description": "Squirreling Async SQL Engine",
   "author": "Hyperparam",
   "homepage": "https://hyperparam.app",
@@ -40,7 +40,7 @@
     "@types/node": "25.3.0",
     "@vitest/coverage-v8": "4.0.18",
     "eslint": "9.39.2",
-    "eslint-plugin-jsdoc": "62.6.1",
+    "eslint-plugin-jsdoc": "62.7.1",
     "typescript": "5.9.3",
     "vitest": "4.0.18"
   }

package/src/backend/dataSource.js

@@ -1,5 +1,5 @@
 /**
- * @import { AsyncCells, AsyncDataSource, AsyncRow, ScanOptions, ScanResults, SqlPrimitive } from '../types.js'
+ * @import { AsyncCells, AsyncDataSource, AsyncRow, SqlPrimitive } from '../types.js'
  */
 
 /**
@@ -8,7 +8,7 @@
  * @param {Record<string, SqlPrimitive>} obj - the plain object
  * @returns {AsyncRow} a row accessor interface
  */
-function asyncRow(obj) {
+export function asyncRow(obj) {
   /** @type {AsyncCells} */
   const cells = {}
   for (const [key, value] of Object.entries(obj)) {

package/src/expression/evaluate.js

@@ -2,13 +2,14 @@ import { executeSelect } from '../execute/execute.js'
 import { stringify } from '../execute/utils.js'
 import { columnNotFoundError, invalidContextError } from '../executionErrors.js'
 import { unknownFunctionError } from '../parseErrors.js'
-import { isAggregateFunc, isMathFunc, isRegexpFunc, isStringFunc } from '../validation.js'
+import { isAggregateFunc, isMathFunc, isRegexpFunc, isSpatialFunc, isStringFunc } from '../validation.js'
 import { aggregateError, argValueError, castError } from '../validationErrors.js'
 import { derivedAlias } from './alias.js'
 import { applyBinaryOp } from './binary.js'
 import { applyIntervalToDate } from './date.js'
 import { evaluateMathFunc } from './math.js'
 import { evaluateRegexpFunc } from './regexp.js'
+import { evaluateSpatialFunc } from './spatial.js'
 import { evaluateStringFunc } from './strings.js'
 
 /**
@@ -250,6 +251,10 @@ export async function evaluateExpr({ node, row, rowIndex, rows, context }) {
       return evaluateMathFunc({ funcName, args })
     }
 
+    if (isSpatialFunc(funcName)) {
+      return evaluateSpatialFunc({ funcName, args })
+    }
+
     if (funcName === 'COALESCE') {
       // Short-circuit: evaluate args one at a time, return first non-null
       for (const arg of node.args) {
@@ -308,6 +313,32 @@ export async function evaluateExpr({ node, row, rowIndex, rows, context }) {
       return result
     }
 
+    if (funcName === 'ARRAY_LENGTH' || funcName === 'CARDINALITY') {
+      const arr = args[0]
+      if (!Array.isArray(arr)) return null
+      return arr.length
+    }
+
+    if (funcName === 'ARRAY_POSITION') {
+      const [arr, target] = args
+      if (!Array.isArray(arr)) return null
+      const index = arr.indexOf(target)
+      return index === -1 ? null : index + 1
+    }
+
+    if (funcName === 'ARRAY_SORT') {
+      const arr = args[0]
+      if (!Array.isArray(arr)) return null
+      return [...arr].sort((a, b) => {
+        if (a == null && b == null) return 0
+        if (a == null) return 1
+        if (b == null) return -1
+        if (a < b) return -1
+        if (a > b) return 1
+        return 0
+      })
+    }
+
     if (funcName === 'JSON_VALUE' || funcName === 'JSON_QUERY') {
       let jsonArg = args[0]
       const pathArg = args[1]