@math.gl/sql 0.0.0-stage → 5.0.0-beta.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (334) hide show
  1. package/LICENSE +249 -0
  2. package/README.md +26 -2
  3. package/THIRD-PARTY-NOTICES.md +5 -0
  4. package/dist/arrow/aggregates.d.ts +46 -0
  5. package/dist/arrow/aggregates.d.ts.map +1 -0
  6. package/dist/arrow/aggregates.js +289 -0
  7. package/dist/arrow/aggregates.js.map +1 -0
  8. package/dist/arrow/buffers.d.ts +30 -0
  9. package/dist/arrow/buffers.d.ts.map +1 -0
  10. package/dist/arrow/buffers.js +177 -0
  11. package/dist/arrow/buffers.js.map +1 -0
  12. package/dist/arrow/cast.d.ts +19 -0
  13. package/dist/arrow/cast.d.ts.map +1 -0
  14. package/dist/arrow/cast.js +138 -0
  15. package/dist/arrow/cast.js.map +1 -0
  16. package/dist/arrow/compiler.d.ts +10 -0
  17. package/dist/arrow/compiler.d.ts.map +1 -0
  18. package/dist/arrow/compiler.js +1421 -0
  19. package/dist/arrow/compiler.js.map +1 -0
  20. package/dist/arrow/float16.d.ts +7 -0
  21. package/dist/arrow/float16.d.ts.map +1 -0
  22. package/dist/arrow/float16.js +26 -0
  23. package/dist/arrow/float16.js.map +1 -0
  24. package/dist/arrow/index.cjs +3220 -0
  25. package/dist/arrow/index.cjs.map +6 -0
  26. package/dist/arrow/index.d.ts +5 -0
  27. package/dist/arrow/index.d.ts.map +1 -0
  28. package/dist/arrow/index.js +7 -0
  29. package/dist/arrow/index.js.map +1 -0
  30. package/dist/arrow/like.d.ts +3 -0
  31. package/dist/arrow/like.d.ts.map +1 -0
  32. package/dist/arrow/like.js +75 -0
  33. package/dist/arrow/like.js.map +1 -0
  34. package/dist/arrow/list-values.d.ts +14 -0
  35. package/dist/arrow/list-values.d.ts.map +1 -0
  36. package/dist/arrow/list-values.js +180 -0
  37. package/dist/arrow/list-values.js.map +1 -0
  38. package/dist/arrow/predicate.d.ts +7 -0
  39. package/dist/arrow/predicate.d.ts.map +1 -0
  40. package/dist/arrow/predicate.js +10 -0
  41. package/dist/arrow/predicate.js.map +1 -0
  42. package/dist/arrow/query-arrow-aggregate-snapshots.d.ts +24 -0
  43. package/dist/arrow/query-arrow-aggregate-snapshots.d.ts.map +1 -0
  44. package/dist/arrow/query-arrow-aggregate-snapshots.js +64 -0
  45. package/dist/arrow/query-arrow-aggregate-snapshots.js.map +1 -0
  46. package/dist/arrow/query-arrow-sql.d.ts +8 -0
  47. package/dist/arrow/query-arrow-sql.d.ts.map +1 -0
  48. package/dist/arrow/query-arrow-sql.js +191 -0
  49. package/dist/arrow/query-arrow-sql.js.map +1 -0
  50. package/dist/arrow/query-arrow-table.d.ts +36 -0
  51. package/dist/arrow/query-arrow-table.d.ts.map +1 -0
  52. package/dist/arrow/query-arrow-table.js +208 -0
  53. package/dist/arrow/query-arrow-table.js.map +1 -0
  54. package/dist/arrow/query-worker-entry.d.ts +2 -0
  55. package/dist/arrow/query-worker-entry.d.ts.map +1 -0
  56. package/dist/arrow/query-worker-entry.js +7 -0
  57. package/dist/arrow/query-worker-entry.js.map +1 -0
  58. package/dist/arrow/query-worker.d.ts +65 -0
  59. package/dist/arrow/query-worker.d.ts.map +1 -0
  60. package/dist/arrow/query-worker.js +135 -0
  61. package/dist/arrow/query-worker.js.map +1 -0
  62. package/dist/arrow/registry.d.ts +4 -0
  63. package/dist/arrow/registry.d.ts.map +1 -0
  64. package/dist/arrow/registry.js +65 -0
  65. package/dist/arrow/registry.js.map +1 -0
  66. package/dist/arrow/relational-query.d.ts +36 -0
  67. package/dist/arrow/relational-query.d.ts.map +1 -0
  68. package/dist/arrow/relational-query.js +174 -0
  69. package/dist/arrow/relational-query.js.map +1 -0
  70. package/dist/arrow/replace-arrow-columns.d.ts +8 -0
  71. package/dist/arrow/replace-arrow-columns.d.ts.map +1 -0
  72. package/dist/arrow/replace-arrow-columns.js +63 -0
  73. package/dist/arrow/replace-arrow-columns.js.map +1 -0
  74. package/dist/arrow/signature.d.ts +6 -0
  75. package/dist/arrow/signature.d.ts.map +1 -0
  76. package/dist/arrow/signature.js +51 -0
  77. package/dist/arrow/signature.js.map +1 -0
  78. package/dist/arrow/temporal-cast.d.ts +9 -0
  79. package/dist/arrow/temporal-cast.d.ts.map +1 -0
  80. package/dist/arrow/temporal-cast.js +60 -0
  81. package/dist/arrow/temporal-cast.js.map +1 -0
  82. package/dist/arrow/types.d.ts +62 -0
  83. package/dist/arrow/types.d.ts.map +1 -0
  84. package/dist/arrow/types.js +5 -0
  85. package/dist/arrow/types.js.map +1 -0
  86. package/dist/arrow/worker-entry.d.ts +2 -0
  87. package/dist/arrow/worker-entry.d.ts.map +1 -0
  88. package/dist/arrow/worker-entry.js +9 -0
  89. package/dist/arrow/worker-entry.js.map +1 -0
  90. package/dist/arrow/worker.cjs +3973 -0
  91. package/dist/arrow/worker.cjs.map +6 -0
  92. package/dist/arrow/worker.d.ts +58 -0
  93. package/dist/arrow/worker.d.ts.map +1 -0
  94. package/dist/arrow/worker.js +84 -0
  95. package/dist/arrow/worker.js.map +1 -0
  96. package/dist/color/index.cjs +382 -0
  97. package/dist/color/index.cjs.map +6 -0
  98. package/dist/color/index.d.ts +26 -0
  99. package/dist/color/index.d.ts.map +1 -0
  100. package/dist/color/index.js +306 -0
  101. package/dist/color/index.js.map +1 -0
  102. package/dist/diagnostic-log.d.ts +8 -0
  103. package/dist/diagnostic-log.d.ts.map +1 -0
  104. package/dist/diagnostic-log.js +15 -0
  105. package/dist/diagnostic-log.js.map +1 -0
  106. package/dist/expressions/ast.d.ts +12 -0
  107. package/dist/expressions/ast.d.ts.map +1 -0
  108. package/dist/expressions/ast.js +112 -0
  109. package/dist/expressions/ast.js.map +1 -0
  110. package/dist/expressions/columnar-predicate.d.ts +56 -0
  111. package/dist/expressions/columnar-predicate.d.ts.map +1 -0
  112. package/dist/expressions/columnar-predicate.js +176 -0
  113. package/dist/expressions/columnar-predicate.js.map +1 -0
  114. package/dist/expressions/evaluation-error.d.ts +14 -0
  115. package/dist/expressions/evaluation-error.d.ts.map +1 -0
  116. package/dist/expressions/evaluation-error.js +26 -0
  117. package/dist/expressions/evaluation-error.js.map +1 -0
  118. package/dist/expressions/expression-eval.d.ts +96 -0
  119. package/dist/expressions/expression-eval.d.ts.map +1 -0
  120. package/dist/expressions/expression-eval.js +330 -0
  121. package/dist/expressions/expression-eval.js.map +1 -0
  122. package/dist/expressions/function-libraries.d.ts +63 -0
  123. package/dist/expressions/function-libraries.d.ts.map +1 -0
  124. package/dist/expressions/function-libraries.js +69 -0
  125. package/dist/expressions/function-libraries.js.map +1 -0
  126. package/dist/expressions/function-registry.d.ts +93 -0
  127. package/dist/expressions/function-registry.d.ts.map +1 -0
  128. package/dist/expressions/function-registry.js +139 -0
  129. package/dist/expressions/function-registry.js.map +1 -0
  130. package/dist/expressions/get.d.ts +9 -0
  131. package/dist/expressions/get.d.ts.map +1 -0
  132. package/dist/expressions/get.js +32 -0
  133. package/dist/expressions/get.js.map +1 -0
  134. package/dist/expressions/index.cjs +1888 -0
  135. package/dist/expressions/index.cjs.map +6 -0
  136. package/dist/expressions/index.d.ts +13 -0
  137. package/dist/expressions/index.d.ts.map +1 -0
  138. package/dist/expressions/index.js +14 -0
  139. package/dist/expressions/index.js.map +1 -0
  140. package/dist/expressions/numeric-functions.d.ts +277 -0
  141. package/dist/expressions/numeric-functions.d.ts.map +1 -0
  142. package/dist/expressions/numeric-functions.js +52 -0
  143. package/dist/expressions/numeric-functions.js.map +1 -0
  144. package/dist/expressions/parse-expression-string.d.ts +21 -0
  145. package/dist/expressions/parse-expression-string.d.ts.map +1 -0
  146. package/dist/expressions/parse-expression-string.js +61 -0
  147. package/dist/expressions/parse-expression-string.js.map +1 -0
  148. package/dist/expressions/predicate-expression.d.ts +7 -0
  149. package/dist/expressions/predicate-expression.d.ts.map +1 -0
  150. package/dist/expressions/predicate-expression.js +112 -0
  151. package/dist/expressions/predicate-expression.js.map +1 -0
  152. package/dist/expressions/scalar-type.d.ts +6 -0
  153. package/dist/expressions/scalar-type.d.ts.map +1 -0
  154. package/dist/expressions/scalar-type.js +23 -0
  155. package/dist/expressions/scalar-type.js.map +1 -0
  156. package/dist/expressions/vendor/jsep/runtime.d.ts +3 -0
  157. package/dist/expressions/vendor/jsep/runtime.d.ts.map +1 -0
  158. package/dist/expressions/vendor/jsep/runtime.js +972 -0
  159. package/dist/expressions/vendor/jsep/runtime.js.map +1 -0
  160. package/dist/expressions/vendor/jsep/types.d.ts +148 -0
  161. package/dist/expressions/vendor/jsep/types.d.ts.map +1 -0
  162. package/dist/expressions/vendor/jsep/types.js +6 -0
  163. package/dist/expressions/vendor/jsep/types.js.map +1 -0
  164. package/dist/index.cjs +4865 -0
  165. package/dist/index.cjs.map +6 -0
  166. package/dist/index.d.ts +9 -0
  167. package/dist/index.d.ts.map +1 -0
  168. package/dist/index.js +10 -0
  169. package/dist/index.js.map +1 -0
  170. package/dist/math/index.cjs +444 -0
  171. package/dist/math/index.cjs.map +6 -0
  172. package/dist/math/index.d.ts +44 -0
  173. package/dist/math/index.d.ts.map +1 -0
  174. package/dist/math/index.js +182 -0
  175. package/dist/math/index.js.map +1 -0
  176. package/dist/scales/arrow-domains.d.ts +15 -0
  177. package/dist/scales/arrow-domains.d.ts.map +1 -0
  178. package/dist/scales/arrow-domains.js +124 -0
  179. package/dist/scales/arrow-domains.js.map +1 -0
  180. package/dist/scales/arrow-scales.cjs +3837 -0
  181. package/dist/scales/arrow-scales.cjs.map +6 -0
  182. package/dist/scales/arrow-scales.d.ts +20 -0
  183. package/dist/scales/arrow-scales.d.ts.map +1 -0
  184. package/dist/scales/arrow-scales.js +109 -0
  185. package/dist/scales/arrow-scales.js.map +1 -0
  186. package/dist/scales/compile-scale.d.ts +7 -0
  187. package/dist/scales/compile-scale.d.ts.map +1 -0
  188. package/dist/scales/compile-scale.js +195 -0
  189. package/dist/scales/compile-scale.js.map +1 -0
  190. package/dist/scales/hdr-colors.d.ts +13 -0
  191. package/dist/scales/hdr-colors.d.ts.map +1 -0
  192. package/dist/scales/hdr-colors.js +115 -0
  193. package/dist/scales/hdr-colors.js.map +1 -0
  194. package/dist/scales/index.cjs +1214 -0
  195. package/dist/scales/index.cjs.map +6 -0
  196. package/dist/scales/index.d.ts +9 -0
  197. package/dist/scales/index.d.ts.map +1 -0
  198. package/dist/scales/index.js +10 -0
  199. package/dist/scales/index.js.map +1 -0
  200. package/dist/scales/palettes.d.ts +5 -0
  201. package/dist/scales/palettes.d.ts.map +1 -0
  202. package/dist/scales/palettes.js +85 -0
  203. package/dist/scales/palettes.js.map +1 -0
  204. package/dist/scales/parse-sql-scale.d.ts +14 -0
  205. package/dist/scales/parse-sql-scale.d.ts.map +1 -0
  206. package/dist/scales/parse-sql-scale.js +165 -0
  207. package/dist/scales/parse-sql-scale.js.map +1 -0
  208. package/dist/scales/quantile-sketch.d.ts +22 -0
  209. package/dist/scales/quantile-sketch.d.ts.map +1 -0
  210. package/dist/scales/quantile-sketch.js +108 -0
  211. package/dist/scales/quantile-sketch.js.map +1 -0
  212. package/dist/scales/scale-types.d.ts +92 -0
  213. package/dist/scales/scale-types.d.ts.map +1 -0
  214. package/dist/scales/scale-types.js +119 -0
  215. package/dist/scales/scale-types.js.map +1 -0
  216. package/dist/scales/streaming-domains.d.ts +18 -0
  217. package/dist/scales/streaming-domains.d.ts.map +1 -0
  218. package/dist/scales/streaming-domains.js +109 -0
  219. package/dist/scales/streaming-domains.js.map +1 -0
  220. package/dist/sql/bind-sql-predicate.d.ts +4 -0
  221. package/dist/sql/bind-sql-predicate.d.ts.map +1 -0
  222. package/dist/sql/bind-sql-predicate.js +11 -0
  223. package/dist/sql/bind-sql-predicate.js.map +1 -0
  224. package/dist/sql/index.cjs +1588 -0
  225. package/dist/sql/index.cjs.map +6 -0
  226. package/dist/sql/index.d.ts +10 -0
  227. package/dist/sql/index.d.ts.map +1 -0
  228. package/dist/sql/index.js +10 -0
  229. package/dist/sql/index.js.map +1 -0
  230. package/dist/sql/parse-sql-expression.d.ts +44 -0
  231. package/dist/sql/parse-sql-expression.d.ts.map +1 -0
  232. package/dist/sql/parse-sql-expression.js +455 -0
  233. package/dist/sql/parse-sql-expression.js.map +1 -0
  234. package/dist/sql/parse-sql-predicate.d.ts +13 -0
  235. package/dist/sql/parse-sql-predicate.d.ts.map +1 -0
  236. package/dist/sql/parse-sql-predicate.js +365 -0
  237. package/dist/sql/parse-sql-predicate.js.map +1 -0
  238. package/dist/sql/parse-sql-query.d.ts +8 -0
  239. package/dist/sql/parse-sql-query.d.ts.map +1 -0
  240. package/dist/sql/parse-sql-query.js +66 -0
  241. package/dist/sql/parse-sql-query.js.map +1 -0
  242. package/dist/sql/parse-sql-select.d.ts +55 -0
  243. package/dist/sql/parse-sql-select.d.ts.map +1 -0
  244. package/dist/sql/parse-sql-select.js +244 -0
  245. package/dist/sql/parse-sql-select.js.map +1 -0
  246. package/dist/sql/parse-sql-statement.d.ts +50 -0
  247. package/dist/sql/parse-sql-statement.d.ts.map +1 -0
  248. package/dist/sql/parse-sql-statement.js +182 -0
  249. package/dist/sql/parse-sql-statement.js.map +1 -0
  250. package/dist/sql/query-types.d.ts +56 -0
  251. package/dist/sql/query-types.d.ts.map +1 -0
  252. package/dist/sql/query-types.js +5 -0
  253. package/dist/sql/query-types.js.map +1 -0
  254. package/dist/sql/sql-parse-error.d.ts +13 -0
  255. package/dist/sql/sql-parse-error.d.ts.map +1 -0
  256. package/dist/sql/sql-parse-error.js +20 -0
  257. package/dist/sql/sql-parse-error.js.map +1 -0
  258. package/dist/sql/sql-predicate-schema.d.ts +164 -0
  259. package/dist/sql/sql-predicate-schema.d.ts.map +1 -0
  260. package/dist/sql/sql-predicate-schema.js +249 -0
  261. package/dist/sql/sql-predicate-schema.js.map +1 -0
  262. package/dist/sql/sql-predicate-types.d.ts +48 -0
  263. package/dist/sql/sql-predicate-types.d.ts.map +1 -0
  264. package/dist/sql/sql-predicate-types.js +9 -0
  265. package/dist/sql/sql-predicate-types.js.map +1 -0
  266. package/dist/sql/sql-predicate.d.ts +6 -0
  267. package/dist/sql/sql-predicate.d.ts.map +1 -0
  268. package/dist/sql/sql-predicate.js +8 -0
  269. package/dist/sql/sql-predicate.js.map +1 -0
  270. package/package.json +92 -4
  271. package/src/arrow/aggregates.ts +386 -0
  272. package/src/arrow/buffers.ts +177 -0
  273. package/src/arrow/cast.ts +160 -0
  274. package/src/arrow/compiler.ts +1659 -0
  275. package/src/arrow/float16.ts +25 -0
  276. package/src/arrow/index.ts +22 -0
  277. package/src/arrow/like.ts +72 -0
  278. package/src/arrow/list-values.ts +200 -0
  279. package/src/arrow/predicate.ts +19 -0
  280. package/src/arrow/query-arrow-aggregate-snapshots.ts +107 -0
  281. package/src/arrow/query-arrow-sql.ts +227 -0
  282. package/src/arrow/query-arrow-table.ts +298 -0
  283. package/src/arrow/query-worker-entry.ts +8 -0
  284. package/src/arrow/query-worker.ts +190 -0
  285. package/src/arrow/registry.ts +86 -0
  286. package/src/arrow/relational-query.ts +247 -0
  287. package/src/arrow/replace-arrow-columns.ts +71 -0
  288. package/src/arrow/signature.ts +50 -0
  289. package/src/arrow/temporal-cast.ts +66 -0
  290. package/src/arrow/types.ts +76 -0
  291. package/src/arrow/worker-entry.ts +10 -0
  292. package/src/arrow/worker.ts +139 -0
  293. package/src/color/index.ts +405 -0
  294. package/src/diagnostic-log.ts +20 -0
  295. package/src/expressions/ast.ts +141 -0
  296. package/src/expressions/columnar-predicate.ts +293 -0
  297. package/src/expressions/evaluation-error.ts +29 -0
  298. package/src/expressions/expression-eval.ts +480 -0
  299. package/src/expressions/function-libraries.ts +126 -0
  300. package/src/expressions/function-registry.ts +171 -0
  301. package/src/expressions/get.ts +37 -0
  302. package/src/expressions/index.ts +40 -0
  303. package/src/expressions/numeric-functions.ts +99 -0
  304. package/src/expressions/parse-expression-string.ts +80 -0
  305. package/src/expressions/predicate-expression.ts +128 -0
  306. package/src/expressions/scalar-type.ts +39 -0
  307. package/src/expressions/vendor/jsep/LICENSE.txt +23 -0
  308. package/src/expressions/vendor/jsep/README.md +22 -0
  309. package/src/expressions/vendor/jsep/runtime.ts +949 -0
  310. package/src/expressions/vendor/jsep/types.ts +191 -0
  311. package/src/index.ts +40 -0
  312. package/src/math/index.ts +235 -0
  313. package/src/scales/arrow-domains.ts +131 -0
  314. package/src/scales/arrow-scales.ts +156 -0
  315. package/src/scales/compile-scale.ts +217 -0
  316. package/src/scales/hdr-colors.ts +126 -0
  317. package/src/scales/index.ts +35 -0
  318. package/src/scales/palettes.ts +86 -0
  319. package/src/scales/parse-sql-scale.ts +195 -0
  320. package/src/scales/quantile-sketch.ts +106 -0
  321. package/src/scales/scale-types.ts +224 -0
  322. package/src/scales/streaming-domains.ts +133 -0
  323. package/src/sql/bind-sql-predicate.ts +21 -0
  324. package/src/sql/index.ts +28 -0
  325. package/src/sql/parse-sql-expression.ts +457 -0
  326. package/src/sql/parse-sql-predicate.ts +454 -0
  327. package/src/sql/parse-sql-query.ts +72 -0
  328. package/src/sql/parse-sql-select.ts +266 -0
  329. package/src/sql/parse-sql-statement.ts +242 -0
  330. package/src/sql/query-types.ts +71 -0
  331. package/src/sql/sql-parse-error.ts +33 -0
  332. package/src/sql/sql-predicate-schema.ts +279 -0
  333. package/src/sql/sql-predicate-types.ts +91 -0
  334. package/src/sql/sql-predicate.ts +28 -0
@@ -0,0 +1,279 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+
5
+ import {isColumnarScalarType, COLUMNAR_SCALAR_TYPES} from '../expressions/scalar-type';
6
+
7
+ import {
8
+ isSQLPredicateParameter,
9
+ type SQLPredicate,
10
+ type SQLPredicateValue
11
+ } from './sql-predicate-types';
12
+
13
+ const MAXIMUM_PREDICATE_DEPTH = 64;
14
+ const MAXIMUM_PREDICATE_NODES = 4096;
15
+
16
+ /**
17
+ * JSON Schema for the JSON-serializable portion of the math.gl SQL predicate AST.
18
+ *
19
+ * In-process predicates additionally accept `bigint`, `Date`, and `Uint8Array` values, which JSON
20
+ * Schema cannot represent directly.
21
+ */
22
+ export const SQL_PREDICATE_JSON_SCHEMA = {
23
+ $schema: 'https://json-schema.org/draft/2020-12/schema',
24
+ $id: 'https://math.gl/schemas/sql-predicate.schema.json',
25
+ title: 'math.gl SQL predicate',
26
+ oneOf: [
27
+ {$ref: '#/$defs/comparison'},
28
+ {$ref: '#/$defs/in'},
29
+ {$ref: '#/$defs/isNull'},
30
+ {$ref: '#/$defs/logical'},
31
+ {$ref: '#/$defs/not'}
32
+ ],
33
+ $defs: {
34
+ property: {
35
+ type: 'object',
36
+ required: ['property'],
37
+ properties: {
38
+ property: {type: 'string', minLength: 1},
39
+ quoted: {type: 'boolean'},
40
+ casts: {
41
+ type: 'array',
42
+ minItems: 1,
43
+ maxItems: 64,
44
+ items: {enum: COLUMNAR_SCALAR_TYPES as readonly string[]}
45
+ }
46
+ },
47
+ additionalProperties: false
48
+ },
49
+ value: {
50
+ oneOf: [
51
+ {type: ['boolean', 'number', 'string']},
52
+ {
53
+ type: 'object',
54
+ required: ['parameter'],
55
+ properties: {parameter: {type: 'string', minLength: 1}},
56
+ additionalProperties: false
57
+ }
58
+ ]
59
+ },
60
+ comparison: {
61
+ type: 'object',
62
+ required: ['op', 'args'],
63
+ properties: {
64
+ op: {enum: ['=', '<>', '<', '<=', '>', '>=']},
65
+ args: {
66
+ type: 'array',
67
+ prefixItems: [{$ref: '#/$defs/property'}, {$ref: '#/$defs/value'}],
68
+ minItems: 2,
69
+ maxItems: 2
70
+ }
71
+ },
72
+ additionalProperties: false
73
+ },
74
+ in: {
75
+ type: 'object',
76
+ required: ['op', 'args'],
77
+ properties: {
78
+ op: {const: 'in'},
79
+ args: {
80
+ type: 'array',
81
+ prefixItems: [
82
+ {$ref: '#/$defs/property'},
83
+ {type: 'array', items: {$ref: '#/$defs/value'}, minItems: 1}
84
+ ],
85
+ minItems: 2,
86
+ maxItems: 2
87
+ }
88
+ },
89
+ additionalProperties: false
90
+ },
91
+ isNull: {
92
+ type: 'object',
93
+ required: ['op', 'args'],
94
+ properties: {
95
+ op: {const: 'isNull'},
96
+ args: {
97
+ type: 'array',
98
+ prefixItems: [{$ref: '#/$defs/property'}],
99
+ minItems: 1,
100
+ maxItems: 1
101
+ }
102
+ },
103
+ additionalProperties: false
104
+ },
105
+ logical: {
106
+ type: 'object',
107
+ required: ['op', 'args'],
108
+ properties: {
109
+ op: {enum: ['and', 'or']},
110
+ args: {type: 'array', items: {$ref: '#'}, minItems: 2}
111
+ },
112
+ additionalProperties: false
113
+ },
114
+ not: {
115
+ type: 'object',
116
+ required: ['op', 'args'],
117
+ properties: {
118
+ op: {const: 'not'},
119
+ args: {
120
+ type: 'array',
121
+ prefixItems: [{$ref: '#'}],
122
+ minItems: 1,
123
+ maxItems: 1
124
+ }
125
+ },
126
+ additionalProperties: false
127
+ }
128
+ }
129
+ } as const;
130
+
131
+ /** Returns whether an unknown value is a valid portable SQL predicate. */
132
+ export function isSQLPredicate(value: unknown): value is SQLPredicate {
133
+ try {
134
+ validateSQLPredicate(value);
135
+ return true;
136
+ } catch {
137
+ return false;
138
+ }
139
+ }
140
+
141
+ /** Validates an unknown portable SQL predicate or throws a path-specific error. */
142
+ export function validateSQLPredicate(value: unknown): asserts value is SQLPredicate {
143
+ const state = {nodes: 0};
144
+ validatePredicateNode(value, '$', 0, state);
145
+ }
146
+
147
+ /** Validates one recursive predicate node. */
148
+ function validatePredicateNode(
149
+ value: unknown,
150
+ path: string,
151
+ depth: number,
152
+ state: {nodes: number}
153
+ ): asserts value is SQLPredicate {
154
+ if (depth > MAXIMUM_PREDICATE_DEPTH) {
155
+ throw new Error(`SQL predicate ${path} exceeds the maximum nesting depth`);
156
+ }
157
+ state.nodes++;
158
+ if (state.nodes > MAXIMUM_PREDICATE_NODES) {
159
+ throw new Error('SQL predicate exceeds the maximum node count');
160
+ }
161
+ if (!isRecord(value) || !hasExactKeys(value, ['op', 'args'])) {
162
+ throw new Error(`SQL predicate ${path} must contain only op and args`);
163
+ }
164
+ if (typeof value['op'] !== 'string' || !Array.isArray(value['args'])) {
165
+ throw new Error(`SQL predicate ${path} requires string op and array args`);
166
+ }
167
+
168
+ switch (value['op']) {
169
+ case 'and':
170
+ case 'or':
171
+ if (value['args'].length < 2) {
172
+ throw new Error(`SQL predicate ${path}.${value['op']} requires at least two arguments`);
173
+ }
174
+ for (let index = 0; index < value['args'].length; index++) {
175
+ validatePredicateNode(value['args'][index], `${path}.args[${index}]`, depth + 1, state);
176
+ }
177
+ return;
178
+ case 'not':
179
+ if (value['args'].length !== 1) {
180
+ throw new Error(`SQL predicate ${path}.not requires exactly one argument`);
181
+ }
182
+ validatePredicateNode(value['args'][0], `${path}.args[0]`, depth + 1, state);
183
+ return;
184
+ case 'isNull':
185
+ if (value['args'].length !== 1) {
186
+ throw new Error(`SQL predicate ${path}.isNull requires exactly one argument`);
187
+ }
188
+ validatePredicateProperty(value['args'][0], `${path}.args[0]`);
189
+ return;
190
+ case 'in':
191
+ if (
192
+ value['args'].length !== 2 ||
193
+ !Array.isArray(value['args'][1]) ||
194
+ value['args'][1].length === 0
195
+ ) {
196
+ throw new Error(`SQL predicate ${path}.in requires a property and non-empty value list`);
197
+ }
198
+ validatePredicateProperty(value['args'][0], `${path}.args[0]`);
199
+ for (let index = 0; index < value['args'][1].length; index++) {
200
+ validatePredicateValue(value['args'][1][index], `${path}.args[1][${index}]`);
201
+ }
202
+ return;
203
+ case '=':
204
+ case '<>':
205
+ case '<':
206
+ case '<=':
207
+ case '>':
208
+ case '>=':
209
+ if (value['args'].length !== 2) {
210
+ throw new Error(`SQL predicate ${path}.${value['op']} requires exactly two arguments`);
211
+ }
212
+ validatePredicateProperty(value['args'][0], `${path}.args[0]`);
213
+ validatePredicateValue(value['args'][1], `${path}.args[1]`);
214
+ return;
215
+ default:
216
+ throw new Error(
217
+ `SQL predicate ${path} has unsupported operator ${JSON.stringify(value['op'])}`
218
+ );
219
+ }
220
+ }
221
+
222
+ /** Validates one property reference. */
223
+ function validatePredicateProperty(value: unknown, path: string): void {
224
+ if (
225
+ !isRecord(value) ||
226
+ !hasAllowedKeys(value, ['property', 'quoted', 'casts']) ||
227
+ typeof value['property'] !== 'string' ||
228
+ value['property'].length === 0 ||
229
+ (value['quoted'] !== undefined && typeof value['quoted'] !== 'boolean')
230
+ ) {
231
+ throw new Error(`SQL predicate ${path} requires a non-empty property reference`);
232
+ }
233
+ const casts = value['casts'];
234
+ if (
235
+ casts !== undefined &&
236
+ (!Array.isArray(casts) ||
237
+ !casts.length ||
238
+ casts.length > 64 ||
239
+ Array.from(casts).some(type => !isColumnarScalarType(type)))
240
+ )
241
+ throw new Error(`SQL predicate ${path} has invalid casts`);
242
+ }
243
+
244
+ /** Validates one structured-cloneable predicate scalar. */
245
+ function validatePredicateValue(value: unknown, path: string): asserts value is SQLPredicateValue {
246
+ if (isSQLPredicateParameter(value)) {
247
+ return;
248
+ }
249
+ if (
250
+ typeof value === 'boolean' ||
251
+ typeof value === 'bigint' ||
252
+ typeof value === 'string' ||
253
+ value instanceof Uint8Array
254
+ ) {
255
+ return;
256
+ }
257
+ if (typeof value === 'number' && Number.isFinite(value)) {
258
+ return;
259
+ }
260
+ if (value instanceof Date && Number.isFinite(value.getTime())) {
261
+ return;
262
+ }
263
+ throw new Error(`SQL predicate ${path} contains an unsupported scalar value`);
264
+ }
265
+
266
+ /** Returns whether an unknown value is a non-null object. */
267
+ function isRecord(value: unknown): value is Record<string, unknown> {
268
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
269
+ }
270
+
271
+ /** Returns whether an object contains exactly the expected enumerable keys. */
272
+ function hasExactKeys(value: Record<string, unknown>, expectedKeys: readonly string[]): boolean {
273
+ const keys = Object.keys(value);
274
+ return keys.length === expectedKeys.length && expectedKeys.every(key => keys.includes(key));
275
+ }
276
+
277
+ function hasAllowedKeys(value: Record<string, unknown>, allowedKeys: readonly string[]): boolean {
278
+ return Object.keys(value).every(key => allowedKeys.includes(key));
279
+ }
@@ -0,0 +1,91 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+
5
+ import type {ColumnarScalarType} from '../expressions/scalar-type';
6
+
7
+ import {
8
+ isColumnarPredicateParameter,
9
+ type ColumnarComparisonPredicate,
10
+ type ColumnarInPredicate,
11
+ type ColumnarLogicalPredicate,
12
+ type ColumnarNotPredicate,
13
+ type ColumnarNullPredicate,
14
+ type ColumnarPredicate,
15
+ type ColumnarPredicateInputValue,
16
+ type ColumnarPredicateParameter,
17
+ type ColumnarPredicateParameterValues,
18
+ type ColumnarPredicateValue
19
+ } from '../expressions/columnar-predicate';
20
+
21
+ /** Scalar values supported by portable SQL predicate expressions. */
22
+ export type SQLPredicateScalar = ColumnarPredicateValue;
23
+
24
+ /** Named parameter reference retained in a portable SQL predicate until execution time. */
25
+ export type SQLPredicateParameter = ColumnarPredicateParameter;
26
+
27
+ /** Scalar value or unresolved named parameter accepted by a portable predicate expression. */
28
+ export type SQLPredicateValue = ColumnarPredicateInputValue;
29
+
30
+ /** Runtime values used to bind named predicate parameters before a backend executes them. */
31
+ export type SQLPredicateParameterValues = ColumnarPredicateParameterValues;
32
+
33
+ /** Reference to one column in a portable SQL predicate expression. */
34
+ export type SQLPredicateProperty = Readonly<{
35
+ /** Column or qualified column name. */
36
+ property: string;
37
+ /** Whether the complete property was a quoted SQL identifier. */
38
+ quoted?: boolean;
39
+ /** Explicit conversions, applied in order before predicate comparison. */
40
+ casts?: readonly ColumnarScalarType[];
41
+ }>;
42
+
43
+ /** Binary comparison between a column and a scalar value. */
44
+ export type SQLComparisonPredicate = Readonly<
45
+ ColumnarComparisonPredicate<SQLPredicateValue, SQLPredicateProperty>
46
+ >;
47
+
48
+ /** Membership test between a column and scalar values. */
49
+ export type SQLInPredicate = Readonly<ColumnarInPredicate<SQLPredicateValue, SQLPredicateProperty>>;
50
+
51
+ /** Null test for one column. */
52
+ export type SQLNullPredicate = Readonly<ColumnarNullPredicate<SQLPredicateProperty>>;
53
+
54
+ /** Conjunction or disjunction of two or more predicates. */
55
+ export type SQLLogicalPredicate = Readonly<
56
+ ColumnarLogicalPredicate<SQLPredicateValue, SQLPredicateProperty>
57
+ >;
58
+
59
+ /** Negation of one predicate. */
60
+ export type SQLNotPredicate = Readonly<
61
+ ColumnarNotPredicate<SQLPredicateValue, SQLPredicateProperty>
62
+ >;
63
+
64
+ /**
65
+ * Portable predicate AST emitted by the math.gl SQL expression parser.
66
+ *
67
+ * The expression shape is directionally aligned with CQL2 JSON, but this deliberately small
68
+ * subset does not claim CQL2 conformance.
69
+ */
70
+ export type SQLPredicate =
71
+ | SQLComparisonPredicate
72
+ | SQLInPredicate
73
+ | SQLNullPredicate
74
+ | SQLLogicalPredicate
75
+ | SQLNotPredicate;
76
+
77
+ /** Portable SQL predicate whose named parameters have all been replaced by concrete scalars. */
78
+ export type BoundSQLPredicate = ColumnarPredicate<SQLPredicateScalar, SQLPredicateProperty>;
79
+
80
+ /** Options for parsing one SQL predicate expression. */
81
+ export type SQLPredicateParserOptions = Readonly<{
82
+ /** Named values referenced using SQL parameters such as `:minimumFare`. */
83
+ parameters?: SQLPredicateParameterValues;
84
+ /** Retains named references in the emitted AST instead of resolving them while parsing. */
85
+ preserveParameters?: boolean;
86
+ }>;
87
+
88
+ /** Returns whether a value is a named parameter reference. */
89
+ export function isSQLPredicateParameter(value: unknown): value is SQLPredicateParameter {
90
+ return isColumnarPredicateParameter(value);
91
+ }
@@ -0,0 +1,28 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+
5
+ export {parseSQLPredicate} from './parse-sql-predicate';
6
+ export {
7
+ isSQLPredicate,
8
+ SQL_PREDICATE_JSON_SCHEMA,
9
+ validateSQLPredicate
10
+ } from './sql-predicate-schema';
11
+ export {bindSQLPredicate} from './bind-sql-predicate';
12
+ export {isSQLPredicateParameter} from './sql-predicate-types';
13
+
14
+ export type {
15
+ BoundSQLPredicate,
16
+ SQLComparisonPredicate,
17
+ SQLInPredicate,
18
+ SQLLogicalPredicate,
19
+ SQLNotPredicate,
20
+ SQLNullPredicate,
21
+ SQLPredicate,
22
+ SQLPredicateParameter,
23
+ SQLPredicateParameterValues,
24
+ SQLPredicateParserOptions,
25
+ SQLPredicateProperty,
26
+ SQLPredicateScalar,
27
+ SQLPredicateValue
28
+ } from './sql-predicate-types';