@math.gl/sql 0.0.0-stage → 5.0.0-beta.12
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.
- package/LICENSE +249 -0
- package/README.md +26 -2
- package/THIRD-PARTY-NOTICES.md +5 -0
- package/dist/arrow/aggregates.d.ts +46 -0
- package/dist/arrow/aggregates.d.ts.map +1 -0
- package/dist/arrow/aggregates.js +289 -0
- package/dist/arrow/aggregates.js.map +1 -0
- package/dist/arrow/buffers.d.ts +30 -0
- package/dist/arrow/buffers.d.ts.map +1 -0
- package/dist/arrow/buffers.js +177 -0
- package/dist/arrow/buffers.js.map +1 -0
- package/dist/arrow/cast.d.ts +19 -0
- package/dist/arrow/cast.d.ts.map +1 -0
- package/dist/arrow/cast.js +138 -0
- package/dist/arrow/cast.js.map +1 -0
- package/dist/arrow/compiler.d.ts +10 -0
- package/dist/arrow/compiler.d.ts.map +1 -0
- package/dist/arrow/compiler.js +1538 -0
- package/dist/arrow/compiler.js.map +1 -0
- package/dist/arrow/float16.d.ts +7 -0
- package/dist/arrow/float16.d.ts.map +1 -0
- package/dist/arrow/float16.js +26 -0
- package/dist/arrow/float16.js.map +1 -0
- package/dist/arrow/index.cjs +3321 -0
- package/dist/arrow/index.cjs.map +6 -0
- package/dist/arrow/index.d.ts +5 -0
- package/dist/arrow/index.d.ts.map +1 -0
- package/dist/arrow/index.js +7 -0
- package/dist/arrow/index.js.map +1 -0
- package/dist/arrow/like.d.ts +3 -0
- package/dist/arrow/like.d.ts.map +1 -0
- package/dist/arrow/like.js +75 -0
- package/dist/arrow/like.js.map +1 -0
- package/dist/arrow/list-values.d.ts +14 -0
- package/dist/arrow/list-values.d.ts.map +1 -0
- package/dist/arrow/list-values.js +201 -0
- package/dist/arrow/list-values.js.map +1 -0
- package/dist/arrow/predicate.d.ts +7 -0
- package/dist/arrow/predicate.d.ts.map +1 -0
- package/dist/arrow/predicate.js +10 -0
- package/dist/arrow/predicate.js.map +1 -0
- package/dist/arrow/query-arrow-aggregate-snapshots.d.ts +24 -0
- package/dist/arrow/query-arrow-aggregate-snapshots.d.ts.map +1 -0
- package/dist/arrow/query-arrow-aggregate-snapshots.js +64 -0
- package/dist/arrow/query-arrow-aggregate-snapshots.js.map +1 -0
- package/dist/arrow/query-arrow-sql.d.ts +8 -0
- package/dist/arrow/query-arrow-sql.d.ts.map +1 -0
- package/dist/arrow/query-arrow-sql.js +223 -0
- package/dist/arrow/query-arrow-sql.js.map +1 -0
- package/dist/arrow/query-arrow-table.d.ts +36 -0
- package/dist/arrow/query-arrow-table.d.ts.map +1 -0
- package/dist/arrow/query-arrow-table.js +208 -0
- package/dist/arrow/query-arrow-table.js.map +1 -0
- package/dist/arrow/query-worker-entry.d.ts +2 -0
- package/dist/arrow/query-worker-entry.d.ts.map +1 -0
- package/dist/arrow/query-worker-entry.js +7 -0
- package/dist/arrow/query-worker-entry.js.map +1 -0
- package/dist/arrow/query-worker.d.ts +65 -0
- package/dist/arrow/query-worker.d.ts.map +1 -0
- package/dist/arrow/query-worker.js +135 -0
- package/dist/arrow/query-worker.js.map +1 -0
- package/dist/arrow/registry.d.ts +4 -0
- package/dist/arrow/registry.d.ts.map +1 -0
- package/dist/arrow/registry.js +66 -0
- package/dist/arrow/registry.js.map +1 -0
- package/dist/arrow/relational-query.d.ts +36 -0
- package/dist/arrow/relational-query.d.ts.map +1 -0
- package/dist/arrow/relational-query.js +174 -0
- package/dist/arrow/relational-query.js.map +1 -0
- package/dist/arrow/replace-arrow-columns.d.ts +8 -0
- package/dist/arrow/replace-arrow-columns.d.ts.map +1 -0
- package/dist/arrow/replace-arrow-columns.js +63 -0
- package/dist/arrow/replace-arrow-columns.js.map +1 -0
- package/dist/arrow/signature.d.ts +6 -0
- package/dist/arrow/signature.d.ts.map +1 -0
- package/dist/arrow/signature.js +51 -0
- package/dist/arrow/signature.js.map +1 -0
- package/dist/arrow/temporal-cast.d.ts +9 -0
- package/dist/arrow/temporal-cast.d.ts.map +1 -0
- package/dist/arrow/temporal-cast.js +60 -0
- package/dist/arrow/temporal-cast.js.map +1 -0
- package/dist/arrow/types.d.ts +62 -0
- package/dist/arrow/types.d.ts.map +1 -0
- package/dist/arrow/types.js +5 -0
- package/dist/arrow/types.js.map +1 -0
- package/dist/arrow/unnest-arrow-column.d.ts +22 -0
- package/dist/arrow/unnest-arrow-column.d.ts.map +1 -0
- package/dist/arrow/unnest-arrow-column.js +112 -0
- package/dist/arrow/unnest-arrow-column.js.map +1 -0
- package/dist/arrow/worker-entry.d.ts +2 -0
- package/dist/arrow/worker-entry.d.ts.map +1 -0
- package/dist/arrow/worker-entry.js +9 -0
- package/dist/arrow/worker-entry.js.map +1 -0
- package/dist/arrow/worker.cjs +4074 -0
- package/dist/arrow/worker.cjs.map +6 -0
- package/dist/arrow/worker.d.ts +58 -0
- package/dist/arrow/worker.d.ts.map +1 -0
- package/dist/arrow/worker.js +84 -0
- package/dist/arrow/worker.js.map +1 -0
- package/dist/color-functions/index.cjs +382 -0
- package/dist/color-functions/index.cjs.map +6 -0
- package/dist/color-functions/index.d.ts +26 -0
- package/dist/color-functions/index.d.ts.map +1 -0
- package/dist/color-functions/index.js +306 -0
- package/dist/color-functions/index.js.map +1 -0
- package/dist/diagnostic-log.d.ts +8 -0
- package/dist/diagnostic-log.d.ts.map +1 -0
- package/dist/diagnostic-log.js +15 -0
- package/dist/diagnostic-log.js.map +1 -0
- package/dist/expressions/ast.d.ts +12 -0
- package/dist/expressions/ast.d.ts.map +1 -0
- package/dist/expressions/ast.js +114 -0
- package/dist/expressions/ast.js.map +1 -0
- package/dist/expressions/columnar-predicate.d.ts +56 -0
- package/dist/expressions/columnar-predicate.d.ts.map +1 -0
- package/dist/expressions/columnar-predicate.js +176 -0
- package/dist/expressions/columnar-predicate.js.map +1 -0
- package/dist/expressions/evaluation-error.d.ts +14 -0
- package/dist/expressions/evaluation-error.d.ts.map +1 -0
- package/dist/expressions/evaluation-error.js +26 -0
- package/dist/expressions/evaluation-error.js.map +1 -0
- package/dist/expressions/expression-eval.d.ts +105 -0
- package/dist/expressions/expression-eval.d.ts.map +1 -0
- package/dist/expressions/expression-eval.js +330 -0
- package/dist/expressions/expression-eval.js.map +1 -0
- package/dist/expressions/function-libraries.d.ts +63 -0
- package/dist/expressions/function-libraries.d.ts.map +1 -0
- package/dist/expressions/function-libraries.js +69 -0
- package/dist/expressions/function-libraries.js.map +1 -0
- package/dist/expressions/function-registry.d.ts +93 -0
- package/dist/expressions/function-registry.d.ts.map +1 -0
- package/dist/expressions/function-registry.js +139 -0
- package/dist/expressions/function-registry.js.map +1 -0
- package/dist/expressions/get.d.ts +9 -0
- package/dist/expressions/get.d.ts.map +1 -0
- package/dist/expressions/get.js +32 -0
- package/dist/expressions/get.js.map +1 -0
- package/dist/expressions/index.cjs +1888 -0
- package/dist/expressions/index.cjs.map +6 -0
- package/dist/expressions/index.d.ts +13 -0
- package/dist/expressions/index.d.ts.map +1 -0
- package/dist/expressions/index.js +14 -0
- package/dist/expressions/index.js.map +1 -0
- package/dist/expressions/numeric-functions.d.ts +277 -0
- package/dist/expressions/numeric-functions.d.ts.map +1 -0
- package/dist/expressions/numeric-functions.js +52 -0
- package/dist/expressions/numeric-functions.js.map +1 -0
- package/dist/expressions/parse-expression-string.d.ts +21 -0
- package/dist/expressions/parse-expression-string.d.ts.map +1 -0
- package/dist/expressions/parse-expression-string.js +61 -0
- package/dist/expressions/parse-expression-string.js.map +1 -0
- package/dist/expressions/predicate-expression.d.ts +7 -0
- package/dist/expressions/predicate-expression.d.ts.map +1 -0
- package/dist/expressions/predicate-expression.js +112 -0
- package/dist/expressions/predicate-expression.js.map +1 -0
- package/dist/expressions/scalar-type.d.ts +6 -0
- package/dist/expressions/scalar-type.d.ts.map +1 -0
- package/dist/expressions/scalar-type.js +23 -0
- package/dist/expressions/scalar-type.js.map +1 -0
- package/dist/expressions/vendor/jsep/runtime.d.ts +3 -0
- package/dist/expressions/vendor/jsep/runtime.d.ts.map +1 -0
- package/dist/expressions/vendor/jsep/runtime.js +972 -0
- package/dist/expressions/vendor/jsep/runtime.js.map +1 -0
- package/dist/expressions/vendor/jsep/types.d.ts +148 -0
- package/dist/expressions/vendor/jsep/types.d.ts.map +1 -0
- package/dist/expressions/vendor/jsep/types.js +6 -0
- package/dist/expressions/vendor/jsep/types.js.map +1 -0
- package/dist/index.cjs +5294 -0
- package/dist/index.cjs.map +6 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -0
- package/dist/math-functions/index.cjs +444 -0
- package/dist/math-functions/index.cjs.map +6 -0
- package/dist/math-functions/index.d.ts +44 -0
- package/dist/math-functions/index.d.ts.map +1 -0
- package/dist/math-functions/index.js +182 -0
- package/dist/math-functions/index.js.map +1 -0
- package/dist/parser/bind-sql-predicate.d.ts +4 -0
- package/dist/parser/bind-sql-predicate.d.ts.map +1 -0
- package/dist/parser/bind-sql-predicate.js +11 -0
- package/dist/parser/bind-sql-predicate.js.map +1 -0
- package/dist/parser/index.cjs +1807 -0
- package/dist/parser/index.cjs.map +6 -0
- package/dist/parser/index.d.ts +12 -0
- package/dist/parser/index.d.ts.map +1 -0
- package/dist/parser/index.js +11 -0
- package/dist/parser/index.js.map +1 -0
- package/dist/parser/parameter-snapshots.d.ts +21 -0
- package/dist/parser/parameter-snapshots.d.ts.map +1 -0
- package/dist/parser/parameter-snapshots.js +85 -0
- package/dist/parser/parameter-snapshots.js.map +1 -0
- package/dist/parser/parse-sql-expression.d.ts +50 -0
- package/dist/parser/parse-sql-expression.d.ts.map +1 -0
- package/dist/parser/parse-sql-expression.js +501 -0
- package/dist/parser/parse-sql-expression.js.map +1 -0
- package/dist/parser/parse-sql-predicate.d.ts +13 -0
- package/dist/parser/parse-sql-predicate.d.ts.map +1 -0
- package/dist/parser/parse-sql-predicate.js +365 -0
- package/dist/parser/parse-sql-predicate.js.map +1 -0
- package/dist/parser/parse-sql-query.d.ts +9 -0
- package/dist/parser/parse-sql-query.d.ts.map +1 -0
- package/dist/parser/parse-sql-query.js +81 -0
- package/dist/parser/parse-sql-query.js.map +1 -0
- package/dist/parser/parse-sql-select.d.ts +57 -0
- package/dist/parser/parse-sql-select.d.ts.map +1 -0
- package/dist/parser/parse-sql-select.js +247 -0
- package/dist/parser/parse-sql-select.js.map +1 -0
- package/dist/parser/parse-sql-statement.d.ts +54 -0
- package/dist/parser/parse-sql-statement.d.ts.map +1 -0
- package/dist/parser/parse-sql-statement.js +207 -0
- package/dist/parser/parse-sql-statement.js.map +1 -0
- package/dist/parser/query-types.d.ts +56 -0
- package/dist/parser/query-types.d.ts.map +1 -0
- package/dist/parser/query-types.js +5 -0
- package/dist/parser/query-types.js.map +1 -0
- package/dist/parser/sql-parameters.d.ts +29 -0
- package/dist/parser/sql-parameters.d.ts.map +1 -0
- package/dist/parser/sql-parameters.js +110 -0
- package/dist/parser/sql-parameters.js.map +1 -0
- package/dist/parser/sql-parse-error.d.ts +13 -0
- package/dist/parser/sql-parse-error.d.ts.map +1 -0
- package/dist/parser/sql-parse-error.js +20 -0
- package/dist/parser/sql-parse-error.js.map +1 -0
- package/dist/parser/sql-predicate-schema.d.ts +164 -0
- package/dist/parser/sql-predicate-schema.d.ts.map +1 -0
- package/dist/parser/sql-predicate-schema.js +249 -0
- package/dist/parser/sql-predicate-schema.js.map +1 -0
- package/dist/parser/sql-predicate-types.d.ts +48 -0
- package/dist/parser/sql-predicate-types.d.ts.map +1 -0
- package/dist/parser/sql-predicate-types.js +9 -0
- package/dist/parser/sql-predicate-types.js.map +1 -0
- package/dist/parser/sql-predicate.d.ts +6 -0
- package/dist/parser/sql-predicate.d.ts.map +1 -0
- package/dist/parser/sql-predicate.js +8 -0
- package/dist/parser/sql-predicate.js.map +1 -0
- package/dist/scales/arrow-domains.d.ts +22 -0
- package/dist/scales/arrow-domains.d.ts.map +1 -0
- package/dist/scales/arrow-domains.js +166 -0
- package/dist/scales/arrow-domains.js.map +1 -0
- package/dist/scales/arrow-scales.d.ts +44 -0
- package/dist/scales/arrow-scales.d.ts.map +1 -0
- package/dist/scales/arrow-scales.js +255 -0
- package/dist/scales/arrow-scales.js.map +1 -0
- package/dist/scales/compile-scale.d.ts +2 -0
- package/dist/scales/compile-scale.d.ts.map +1 -0
- package/dist/scales/compile-scale.js +5 -0
- package/dist/scales/compile-scale.js.map +1 -0
- package/dist/scales/conformance.cjs +180 -0
- package/dist/scales/conformance.cjs.map +6 -0
- package/dist/scales/conformance.d.ts +26 -0
- package/dist/scales/conformance.d.ts.map +1 -0
- package/dist/scales/conformance.js +164 -0
- package/dist/scales/conformance.js.map +1 -0
- package/dist/scales/hdr-colors.d.ts +2 -0
- package/dist/scales/hdr-colors.d.ts.map +1 -0
- package/dist/scales/hdr-colors.js +5 -0
- package/dist/scales/hdr-colors.js.map +1 -0
- package/dist/scales/index.cjs +4334 -0
- package/dist/scales/index.cjs.map +6 -0
- package/dist/scales/index.d.ts +10 -0
- package/dist/scales/index.d.ts.map +1 -0
- package/dist/scales/index.js +11 -0
- package/dist/scales/index.js.map +1 -0
- package/dist/scales/palettes.d.ts +2 -0
- package/dist/scales/palettes.d.ts.map +1 -0
- package/dist/scales/palettes.js +5 -0
- package/dist/scales/palettes.js.map +1 -0
- package/dist/scales/parse-sql-scale.d.ts +27 -0
- package/dist/scales/parse-sql-scale.d.ts.map +1 -0
- package/dist/scales/parse-sql-scale.js +257 -0
- package/dist/scales/parse-sql-scale.js.map +1 -0
- package/dist/scales/quantile-sketch.d.ts +2 -0
- package/dist/scales/quantile-sketch.d.ts.map +1 -0
- package/dist/scales/quantile-sketch.js +5 -0
- package/dist/scales/quantile-sketch.js.map +1 -0
- package/dist/scales/scale-types.d.ts +2 -0
- package/dist/scales/scale-types.d.ts.map +1 -0
- package/dist/scales/scale-types.js +5 -0
- package/dist/scales/scale-types.js.map +1 -0
- package/dist/scales/streaming-domains.d.ts +18 -0
- package/dist/scales/streaming-domains.d.ts.map +1 -0
- package/dist/scales/streaming-domains.js +115 -0
- package/dist/scales/streaming-domains.js.map +1 -0
- package/package.json +92 -4
- package/src/arrow/aggregates.ts +386 -0
- package/src/arrow/buffers.ts +177 -0
- package/src/arrow/cast.ts +160 -0
- package/src/arrow/compiler.ts +1778 -0
- package/src/arrow/float16.ts +25 -0
- package/src/arrow/index.ts +22 -0
- package/src/arrow/like.ts +72 -0
- package/src/arrow/list-values.ts +221 -0
- package/src/arrow/predicate.ts +19 -0
- package/src/arrow/query-arrow-aggregate-snapshots.ts +107 -0
- package/src/arrow/query-arrow-sql.ts +255 -0
- package/src/arrow/query-arrow-table.ts +298 -0
- package/src/arrow/query-worker-entry.ts +8 -0
- package/src/arrow/query-worker.ts +194 -0
- package/src/arrow/registry.ts +87 -0
- package/src/arrow/relational-query.ts +247 -0
- package/src/arrow/replace-arrow-columns.ts +71 -0
- package/src/arrow/signature.ts +50 -0
- package/src/arrow/temporal-cast.ts +66 -0
- package/src/arrow/types.ts +76 -0
- package/src/arrow/unnest-arrow-column.ts +145 -0
- package/src/arrow/worker-entry.ts +10 -0
- package/src/arrow/worker.ts +143 -0
- package/src/color-functions/index.ts +405 -0
- package/src/diagnostic-log.ts +20 -0
- package/src/expressions/ast.ts +143 -0
- package/src/expressions/columnar-predicate.ts +293 -0
- package/src/expressions/evaluation-error.ts +29 -0
- package/src/expressions/expression-eval.ts +489 -0
- package/src/expressions/function-libraries.ts +126 -0
- package/src/expressions/function-registry.ts +171 -0
- package/src/expressions/get.ts +37 -0
- package/src/expressions/index.ts +40 -0
- package/src/expressions/numeric-functions.ts +99 -0
- package/src/expressions/parse-expression-string.ts +80 -0
- package/src/expressions/predicate-expression.ts +128 -0
- package/src/expressions/scalar-type.ts +39 -0
- package/src/expressions/vendor/jsep/LICENSE.txt +23 -0
- package/src/expressions/vendor/jsep/runtime.ts +949 -0
- package/src/expressions/vendor/jsep/types.ts +191 -0
- package/src/index.ts +54 -0
- package/src/math-functions/index.ts +235 -0
- package/src/parser/bind-sql-predicate.ts +21 -0
- package/src/parser/index.ts +43 -0
- package/src/parser/parameter-snapshots.ts +103 -0
- package/src/parser/parse-sql-expression.ts +500 -0
- package/src/parser/parse-sql-predicate.ts +454 -0
- package/src/parser/parse-sql-query.ts +90 -0
- package/src/parser/parse-sql-select.ts +272 -0
- package/src/parser/parse-sql-statement.ts +260 -0
- package/src/parser/query-types.ts +71 -0
- package/src/parser/sql-parameters.ts +174 -0
- package/src/parser/sql-parse-error.ts +33 -0
- package/src/parser/sql-predicate-schema.ts +279 -0
- package/src/parser/sql-predicate-types.ts +91 -0
- package/src/parser/sql-predicate.ts +28 -0
- package/src/scales/arrow-domains.ts +190 -0
- package/src/scales/arrow-scales.ts +363 -0
- package/src/scales/compile-scale.ts +5 -0
- package/src/scales/conformance.ts +186 -0
- package/src/scales/hdr-colors.ts +5 -0
- package/src/scales/index.ts +37 -0
- package/src/scales/palettes.ts +5 -0
- package/src/scales/parse-sql-scale.ts +300 -0
- package/src/scales/quantile-sketch.ts +5 -0
- package/src/scales/scale-types.ts +5 -0
- package/src/scales/streaming-domains.ts +139 -0
|
@@ -0,0 +1,110 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
import { isSQLParameterSnapshot, snapshotParameter } from "./parameter-snapshots.js";
|
|
5
|
+
import { isColumnarPredicateValue } from "../expressions/columnar-predicate.js";
|
|
6
|
+
/** Rejects ambiguous binding configuration even when a statement has no placeholders. */
|
|
7
|
+
export function validateSQLParameterOptions(options) {
|
|
8
|
+
if (options.parameters !== undefined && options.parseParameter !== undefined) {
|
|
9
|
+
throw new Error('SQL parameters and parseParameter are mutually exclusive');
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
/** Resolves a named value into a copied literal AST without interpreting it as SQL. */
|
|
13
|
+
export function bindSQLParameter(name, options) {
|
|
14
|
+
if (options.parseParameter)
|
|
15
|
+
return options.parseParameter(name);
|
|
16
|
+
if (isSQLParameterSnapshot(options.parameters))
|
|
17
|
+
return snapshotParameter(options.parameters, name);
|
|
18
|
+
if (!Object.prototype.hasOwnProperty.call(options.parameters ?? {}, name)) {
|
|
19
|
+
throw new Error(`SQL parameter ":${name}" requires a value`);
|
|
20
|
+
}
|
|
21
|
+
const value = options.parameters[name];
|
|
22
|
+
if (isNumericArray(value) && !(value instanceof Uint8Array))
|
|
23
|
+
return typedArrayLiteral(value, name);
|
|
24
|
+
if (value && typeof value === 'object' && 'type' in value) {
|
|
25
|
+
if (value.type === 'array' && isNumericArray(value.value))
|
|
26
|
+
return typedArrayLiteral(value.value, name);
|
|
27
|
+
if ((value.type === 'utf8' || value.type === 'binary') && value.value instanceof Uint8Array) {
|
|
28
|
+
const data = new Uint8Array(value.value);
|
|
29
|
+
if (value.type === 'binary')
|
|
30
|
+
return literal(data);
|
|
31
|
+
try {
|
|
32
|
+
// Retain the portable string value and its supplied physical representation.
|
|
33
|
+
// Scalar evaluators use value; Arrow comparisons consume utf8 directly.
|
|
34
|
+
return {
|
|
35
|
+
type: 'Literal',
|
|
36
|
+
value: new TextDecoder('utf-8', { fatal: true, ignoreBOM: true }).decode(data),
|
|
37
|
+
utf8: data
|
|
38
|
+
};
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
throw new Error(`SQL parameter ":${name}" requires valid UTF-8 bytes`);
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
throw new Error(`SQL parameter ":${name}" has an unsupported binary format`);
|
|
45
|
+
}
|
|
46
|
+
if (Array.isArray(value)) {
|
|
47
|
+
if (value.length > 4096 ||
|
|
48
|
+
!(Array.from(value).every(item => typeof item === 'number' && Number.isFinite(item)) ||
|
|
49
|
+
Array.from(value).every(item => typeof item === 'string') ||
|
|
50
|
+
Array.from(value).every(item => (Array.isArray(item) || isNumericArray(item)) &&
|
|
51
|
+
item.length <= 4096 &&
|
|
52
|
+
Array.from(item).every(component => typeof component === 'number' && Number.isFinite(component)))))
|
|
53
|
+
throw new Error(`SQL parameter ":${name}" has an unsupported array value`);
|
|
54
|
+
return arrayLiteral(value, name);
|
|
55
|
+
}
|
|
56
|
+
if (value !== null && !isColumnarPredicateValue(value)) {
|
|
57
|
+
throw new Error(`SQL parameter ":${name}" has an unsupported value`);
|
|
58
|
+
}
|
|
59
|
+
return literal(value instanceof Date
|
|
60
|
+
? new Date(value.getTime())
|
|
61
|
+
: value instanceof Uint8Array
|
|
62
|
+
? new Uint8Array(value)
|
|
63
|
+
: value);
|
|
64
|
+
}
|
|
65
|
+
/** Builds an independent array tree; array elements are never identifiers or executable text. */
|
|
66
|
+
function arrayLiteral(values, name) {
|
|
67
|
+
return {
|
|
68
|
+
type: 'ArrayExpression',
|
|
69
|
+
elements: Array.from(values, value => Array.isArray(value)
|
|
70
|
+
? arrayLiteral(value, name)
|
|
71
|
+
: isNumericArray(value)
|
|
72
|
+
? typedArrayLiteral(value, name)
|
|
73
|
+
: literal(value))
|
|
74
|
+
};
|
|
75
|
+
}
|
|
76
|
+
/** Creates a typed literal, including scalar values that cannot be represented in JSON. */
|
|
77
|
+
function literal(value) {
|
|
78
|
+
if (value instanceof Uint8Array || value instanceof Date)
|
|
79
|
+
return { type: 'Literal', value };
|
|
80
|
+
return {
|
|
81
|
+
type: 'Literal',
|
|
82
|
+
value,
|
|
83
|
+
raw: typeof value === 'bigint' ? String(value) : JSON.stringify(value)
|
|
84
|
+
};
|
|
85
|
+
}
|
|
86
|
+
/** Recognizes supported numeric storage without treating DataView or bigint arrays as numbers. */
|
|
87
|
+
function isNumericArray(value) {
|
|
88
|
+
return (value instanceof Float32Array ||
|
|
89
|
+
value instanceof Float64Array ||
|
|
90
|
+
value instanceof Int8Array ||
|
|
91
|
+
value instanceof Uint8Array ||
|
|
92
|
+
value instanceof Uint8ClampedArray ||
|
|
93
|
+
value instanceof Int16Array ||
|
|
94
|
+
value instanceof Uint16Array ||
|
|
95
|
+
value instanceof Int32Array ||
|
|
96
|
+
value instanceof Uint32Array);
|
|
97
|
+
}
|
|
98
|
+
/** Snapshots typed input and supplies equivalent portable elements for non-Arrow evaluators. */
|
|
99
|
+
function typedArrayLiteral(value, name) {
|
|
100
|
+
if (value.length > 4096 || !value.every(Number.isFinite)) {
|
|
101
|
+
throw new Error(`SQL parameter ":${name}" has an unsupported numeric array`);
|
|
102
|
+
}
|
|
103
|
+
const typedValues = value instanceof Uint8Array ? new Uint8Array(value) : value.slice();
|
|
104
|
+
return {
|
|
105
|
+
type: 'ArrayExpression',
|
|
106
|
+
elements: Array.from(typedValues, item => literal(item)),
|
|
107
|
+
typedValues
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
//# sourceMappingURL=sql-parameters.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sql-parameters.js","sourceRoot":"","sources":["../../src/parser/sql-parameters.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/** A syntax error with a position in the original SQL input. */
|
|
2
|
+
export declare class SQLParseError extends SyntaxError {
|
|
3
|
+
readonly reason: string;
|
|
4
|
+
/** Zero-based UTF-16 offset. */
|
|
5
|
+
readonly offset: number;
|
|
6
|
+
/** One-based line and column, with CRLF counted as one newline. */
|
|
7
|
+
readonly line: number;
|
|
8
|
+
readonly column: number;
|
|
9
|
+
/** Bounded source preview at the cursor, or null at end of input. */
|
|
10
|
+
readonly token: string | null;
|
|
11
|
+
constructor(reason: string, source: string, offset: number);
|
|
12
|
+
}
|
|
13
|
+
//# sourceMappingURL=sql-parse-error.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sql-parse-error.d.ts","sourceRoot":"","sources":["../../src/parser/sql-parse-error.ts"],"names":[],"mappings":"AAIA,gEAAgE;AAChE,qBAAa,aAAc,SAAQ,WAAW;IAU1C,QAAQ,CAAC,MAAM,EAAE,MAAM;IATzB,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGnB,MAAM,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM;CAejB"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
/** A syntax error with a position in the original SQL input. */
|
|
5
|
+
export class SQLParseError extends SyntaxError {
|
|
6
|
+
constructor(reason, source, offset) {
|
|
7
|
+
const lines = source.slice(0, offset).split(/\r\n|\r|\n/);
|
|
8
|
+
const line = lines.length;
|
|
9
|
+
const column = lines[line - 1].length + 1;
|
|
10
|
+
const token = source.slice(offset, offset + 32).match(/^:?\w+|^\S/u)?.[0] ?? null;
|
|
11
|
+
super(`${reason} (line ${line}, column ${column}${token ? `, near ${JSON.stringify(token)}` : ''})`);
|
|
12
|
+
this.reason = reason;
|
|
13
|
+
this.name = 'SQLParseError';
|
|
14
|
+
this.offset = offset;
|
|
15
|
+
this.line = line;
|
|
16
|
+
this.column = column;
|
|
17
|
+
this.token = token;
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
//# sourceMappingURL=sql-parse-error.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sql-parse-error.js","sourceRoot":"","sources":["../../src/parser/sql-parse-error.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,gEAAgE;AAChE,MAAM,OAAO,aAAc,SAAQ,WAAW;IAS5C,YACW,MAAc,EACvB,MAAc,EACd,MAAc;QAEd,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC1D,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAClF,KAAK,CACH,GAAG,MAAM,UAAU,IAAI,YAAY,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CAC9F,CAAC;QAVO,WAAM,GAAN,MAAM,CAAQ;QAWvB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}
|
|
@@ -0,0 +1,164 @@
|
|
|
1
|
+
import { type SQLPredicate } from "./sql-predicate-types.js";
|
|
2
|
+
/**
|
|
3
|
+
* JSON Schema for the JSON-serializable portion of the math.gl SQL predicate AST.
|
|
4
|
+
*
|
|
5
|
+
* In-process predicates additionally accept `bigint`, `Date`, and `Uint8Array` values, which JSON
|
|
6
|
+
* Schema cannot represent directly.
|
|
7
|
+
*/
|
|
8
|
+
export declare const SQL_PREDICATE_JSON_SCHEMA: {
|
|
9
|
+
readonly $schema: "https://json-schema.org/draft/2020-12/schema";
|
|
10
|
+
readonly $id: "https://math.gl/schemas/sql-predicate.schema.json";
|
|
11
|
+
readonly title: "math.gl SQL predicate";
|
|
12
|
+
readonly oneOf: readonly [{
|
|
13
|
+
readonly $ref: "#/$defs/comparison";
|
|
14
|
+
}, {
|
|
15
|
+
readonly $ref: "#/$defs/in";
|
|
16
|
+
}, {
|
|
17
|
+
readonly $ref: "#/$defs/isNull";
|
|
18
|
+
}, {
|
|
19
|
+
readonly $ref: "#/$defs/logical";
|
|
20
|
+
}, {
|
|
21
|
+
readonly $ref: "#/$defs/not";
|
|
22
|
+
}];
|
|
23
|
+
readonly $defs: {
|
|
24
|
+
readonly property: {
|
|
25
|
+
readonly type: "object";
|
|
26
|
+
readonly required: readonly ["property"];
|
|
27
|
+
readonly properties: {
|
|
28
|
+
readonly property: {
|
|
29
|
+
readonly type: "string";
|
|
30
|
+
readonly minLength: 1;
|
|
31
|
+
};
|
|
32
|
+
readonly quoted: {
|
|
33
|
+
readonly type: "boolean";
|
|
34
|
+
};
|
|
35
|
+
readonly casts: {
|
|
36
|
+
readonly type: "array";
|
|
37
|
+
readonly minItems: 1;
|
|
38
|
+
readonly maxItems: 64;
|
|
39
|
+
readonly items: {
|
|
40
|
+
readonly enum: readonly string[];
|
|
41
|
+
};
|
|
42
|
+
};
|
|
43
|
+
};
|
|
44
|
+
readonly additionalProperties: false;
|
|
45
|
+
};
|
|
46
|
+
readonly value: {
|
|
47
|
+
readonly oneOf: readonly [{
|
|
48
|
+
readonly type: readonly ["boolean", "number", "string"];
|
|
49
|
+
}, {
|
|
50
|
+
readonly type: "object";
|
|
51
|
+
readonly required: readonly ["parameter"];
|
|
52
|
+
readonly properties: {
|
|
53
|
+
readonly parameter: {
|
|
54
|
+
readonly type: "string";
|
|
55
|
+
readonly minLength: 1;
|
|
56
|
+
};
|
|
57
|
+
};
|
|
58
|
+
readonly additionalProperties: false;
|
|
59
|
+
}];
|
|
60
|
+
};
|
|
61
|
+
readonly comparison: {
|
|
62
|
+
readonly type: "object";
|
|
63
|
+
readonly required: readonly ["op", "args"];
|
|
64
|
+
readonly properties: {
|
|
65
|
+
readonly op: {
|
|
66
|
+
readonly enum: readonly ["=", "<>", "<", "<=", ">", ">="];
|
|
67
|
+
};
|
|
68
|
+
readonly args: {
|
|
69
|
+
readonly type: "array";
|
|
70
|
+
readonly prefixItems: readonly [{
|
|
71
|
+
readonly $ref: "#/$defs/property";
|
|
72
|
+
}, {
|
|
73
|
+
readonly $ref: "#/$defs/value";
|
|
74
|
+
}];
|
|
75
|
+
readonly minItems: 2;
|
|
76
|
+
readonly maxItems: 2;
|
|
77
|
+
};
|
|
78
|
+
};
|
|
79
|
+
readonly additionalProperties: false;
|
|
80
|
+
};
|
|
81
|
+
readonly in: {
|
|
82
|
+
readonly type: "object";
|
|
83
|
+
readonly required: readonly ["op", "args"];
|
|
84
|
+
readonly properties: {
|
|
85
|
+
readonly op: {
|
|
86
|
+
readonly const: "in";
|
|
87
|
+
};
|
|
88
|
+
readonly args: {
|
|
89
|
+
readonly type: "array";
|
|
90
|
+
readonly prefixItems: readonly [{
|
|
91
|
+
readonly $ref: "#/$defs/property";
|
|
92
|
+
}, {
|
|
93
|
+
readonly type: "array";
|
|
94
|
+
readonly items: {
|
|
95
|
+
readonly $ref: "#/$defs/value";
|
|
96
|
+
};
|
|
97
|
+
readonly minItems: 1;
|
|
98
|
+
}];
|
|
99
|
+
readonly minItems: 2;
|
|
100
|
+
readonly maxItems: 2;
|
|
101
|
+
};
|
|
102
|
+
};
|
|
103
|
+
readonly additionalProperties: false;
|
|
104
|
+
};
|
|
105
|
+
readonly isNull: {
|
|
106
|
+
readonly type: "object";
|
|
107
|
+
readonly required: readonly ["op", "args"];
|
|
108
|
+
readonly properties: {
|
|
109
|
+
readonly op: {
|
|
110
|
+
readonly const: "isNull";
|
|
111
|
+
};
|
|
112
|
+
readonly args: {
|
|
113
|
+
readonly type: "array";
|
|
114
|
+
readonly prefixItems: readonly [{
|
|
115
|
+
readonly $ref: "#/$defs/property";
|
|
116
|
+
}];
|
|
117
|
+
readonly minItems: 1;
|
|
118
|
+
readonly maxItems: 1;
|
|
119
|
+
};
|
|
120
|
+
};
|
|
121
|
+
readonly additionalProperties: false;
|
|
122
|
+
};
|
|
123
|
+
readonly logical: {
|
|
124
|
+
readonly type: "object";
|
|
125
|
+
readonly required: readonly ["op", "args"];
|
|
126
|
+
readonly properties: {
|
|
127
|
+
readonly op: {
|
|
128
|
+
readonly enum: readonly ["and", "or"];
|
|
129
|
+
};
|
|
130
|
+
readonly args: {
|
|
131
|
+
readonly type: "array";
|
|
132
|
+
readonly items: {
|
|
133
|
+
readonly $ref: "#";
|
|
134
|
+
};
|
|
135
|
+
readonly minItems: 2;
|
|
136
|
+
};
|
|
137
|
+
};
|
|
138
|
+
readonly additionalProperties: false;
|
|
139
|
+
};
|
|
140
|
+
readonly not: {
|
|
141
|
+
readonly type: "object";
|
|
142
|
+
readonly required: readonly ["op", "args"];
|
|
143
|
+
readonly properties: {
|
|
144
|
+
readonly op: {
|
|
145
|
+
readonly const: "not";
|
|
146
|
+
};
|
|
147
|
+
readonly args: {
|
|
148
|
+
readonly type: "array";
|
|
149
|
+
readonly prefixItems: readonly [{
|
|
150
|
+
readonly $ref: "#";
|
|
151
|
+
}];
|
|
152
|
+
readonly minItems: 1;
|
|
153
|
+
readonly maxItems: 1;
|
|
154
|
+
};
|
|
155
|
+
};
|
|
156
|
+
readonly additionalProperties: false;
|
|
157
|
+
};
|
|
158
|
+
};
|
|
159
|
+
};
|
|
160
|
+
/** Returns whether an unknown value is a valid portable SQL predicate. */
|
|
161
|
+
export declare function isSQLPredicate(value: unknown): value is SQLPredicate;
|
|
162
|
+
/** Validates an unknown portable SQL predicate or throws a path-specific error. */
|
|
163
|
+
export declare function validateSQLPredicate(value: unknown): asserts value is SQLPredicate;
|
|
164
|
+
//# sourceMappingURL=sql-predicate-schema.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sql-predicate-schema.d.ts","sourceRoot":"","sources":["../../src/parser/sql-predicate-schema.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,YAAY,EAElB,iCAA8B;AAK/B;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uCAsBW,SAAS,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqFxD,CAAC;AAEX,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAOpE;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,YAAY,CAGlF"}
|
|
@@ -0,0 +1,249 @@
|
|
|
1
|
+
// math.gl
|
|
2
|
+
// SPDX-License-Identifier: MIT
|
|
3
|
+
// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
|
|
4
|
+
import { isColumnarScalarType, COLUMNAR_SCALAR_TYPES } from "../expressions/scalar-type.js";
|
|
5
|
+
import { isSQLPredicateParameter } from "./sql-predicate-types.js";
|
|
6
|
+
const MAXIMUM_PREDICATE_DEPTH = 64;
|
|
7
|
+
const MAXIMUM_PREDICATE_NODES = 4096;
|
|
8
|
+
/**
|
|
9
|
+
* JSON Schema for the JSON-serializable portion of the math.gl SQL predicate AST.
|
|
10
|
+
*
|
|
11
|
+
* In-process predicates additionally accept `bigint`, `Date`, and `Uint8Array` values, which JSON
|
|
12
|
+
* Schema cannot represent directly.
|
|
13
|
+
*/
|
|
14
|
+
export const SQL_PREDICATE_JSON_SCHEMA = {
|
|
15
|
+
$schema: 'https://json-schema.org/draft/2020-12/schema',
|
|
16
|
+
$id: 'https://math.gl/schemas/sql-predicate.schema.json',
|
|
17
|
+
title: 'math.gl SQL predicate',
|
|
18
|
+
oneOf: [
|
|
19
|
+
{ $ref: '#/$defs/comparison' },
|
|
20
|
+
{ $ref: '#/$defs/in' },
|
|
21
|
+
{ $ref: '#/$defs/isNull' },
|
|
22
|
+
{ $ref: '#/$defs/logical' },
|
|
23
|
+
{ $ref: '#/$defs/not' }
|
|
24
|
+
],
|
|
25
|
+
$defs: {
|
|
26
|
+
property: {
|
|
27
|
+
type: 'object',
|
|
28
|
+
required: ['property'],
|
|
29
|
+
properties: {
|
|
30
|
+
property: { type: 'string', minLength: 1 },
|
|
31
|
+
quoted: { type: 'boolean' },
|
|
32
|
+
casts: {
|
|
33
|
+
type: 'array',
|
|
34
|
+
minItems: 1,
|
|
35
|
+
maxItems: 64,
|
|
36
|
+
items: { enum: COLUMNAR_SCALAR_TYPES }
|
|
37
|
+
}
|
|
38
|
+
},
|
|
39
|
+
additionalProperties: false
|
|
40
|
+
},
|
|
41
|
+
value: {
|
|
42
|
+
oneOf: [
|
|
43
|
+
{ type: ['boolean', 'number', 'string'] },
|
|
44
|
+
{
|
|
45
|
+
type: 'object',
|
|
46
|
+
required: ['parameter'],
|
|
47
|
+
properties: { parameter: { type: 'string', minLength: 1 } },
|
|
48
|
+
additionalProperties: false
|
|
49
|
+
}
|
|
50
|
+
]
|
|
51
|
+
},
|
|
52
|
+
comparison: {
|
|
53
|
+
type: 'object',
|
|
54
|
+
required: ['op', 'args'],
|
|
55
|
+
properties: {
|
|
56
|
+
op: { enum: ['=', '<>', '<', '<=', '>', '>='] },
|
|
57
|
+
args: {
|
|
58
|
+
type: 'array',
|
|
59
|
+
prefixItems: [{ $ref: '#/$defs/property' }, { $ref: '#/$defs/value' }],
|
|
60
|
+
minItems: 2,
|
|
61
|
+
maxItems: 2
|
|
62
|
+
}
|
|
63
|
+
},
|
|
64
|
+
additionalProperties: false
|
|
65
|
+
},
|
|
66
|
+
in: {
|
|
67
|
+
type: 'object',
|
|
68
|
+
required: ['op', 'args'],
|
|
69
|
+
properties: {
|
|
70
|
+
op: { const: 'in' },
|
|
71
|
+
args: {
|
|
72
|
+
type: 'array',
|
|
73
|
+
prefixItems: [
|
|
74
|
+
{ $ref: '#/$defs/property' },
|
|
75
|
+
{ type: 'array', items: { $ref: '#/$defs/value' }, minItems: 1 }
|
|
76
|
+
],
|
|
77
|
+
minItems: 2,
|
|
78
|
+
maxItems: 2
|
|
79
|
+
}
|
|
80
|
+
},
|
|
81
|
+
additionalProperties: false
|
|
82
|
+
},
|
|
83
|
+
isNull: {
|
|
84
|
+
type: 'object',
|
|
85
|
+
required: ['op', 'args'],
|
|
86
|
+
properties: {
|
|
87
|
+
op: { const: 'isNull' },
|
|
88
|
+
args: {
|
|
89
|
+
type: 'array',
|
|
90
|
+
prefixItems: [{ $ref: '#/$defs/property' }],
|
|
91
|
+
minItems: 1,
|
|
92
|
+
maxItems: 1
|
|
93
|
+
}
|
|
94
|
+
},
|
|
95
|
+
additionalProperties: false
|
|
96
|
+
},
|
|
97
|
+
logical: {
|
|
98
|
+
type: 'object',
|
|
99
|
+
required: ['op', 'args'],
|
|
100
|
+
properties: {
|
|
101
|
+
op: { enum: ['and', 'or'] },
|
|
102
|
+
args: { type: 'array', items: { $ref: '#' }, minItems: 2 }
|
|
103
|
+
},
|
|
104
|
+
additionalProperties: false
|
|
105
|
+
},
|
|
106
|
+
not: {
|
|
107
|
+
type: 'object',
|
|
108
|
+
required: ['op', 'args'],
|
|
109
|
+
properties: {
|
|
110
|
+
op: { const: 'not' },
|
|
111
|
+
args: {
|
|
112
|
+
type: 'array',
|
|
113
|
+
prefixItems: [{ $ref: '#' }],
|
|
114
|
+
minItems: 1,
|
|
115
|
+
maxItems: 1
|
|
116
|
+
}
|
|
117
|
+
},
|
|
118
|
+
additionalProperties: false
|
|
119
|
+
}
|
|
120
|
+
}
|
|
121
|
+
};
|
|
122
|
+
/** Returns whether an unknown value is a valid portable SQL predicate. */
|
|
123
|
+
export function isSQLPredicate(value) {
|
|
124
|
+
try {
|
|
125
|
+
validateSQLPredicate(value);
|
|
126
|
+
return true;
|
|
127
|
+
}
|
|
128
|
+
catch {
|
|
129
|
+
return false;
|
|
130
|
+
}
|
|
131
|
+
}
|
|
132
|
+
/** Validates an unknown portable SQL predicate or throws a path-specific error. */
|
|
133
|
+
export function validateSQLPredicate(value) {
|
|
134
|
+
const state = { nodes: 0 };
|
|
135
|
+
validatePredicateNode(value, '$', 0, state);
|
|
136
|
+
}
|
|
137
|
+
/** Validates one recursive predicate node. */
|
|
138
|
+
function validatePredicateNode(value, path, depth, state) {
|
|
139
|
+
if (depth > MAXIMUM_PREDICATE_DEPTH) {
|
|
140
|
+
throw new Error(`SQL predicate ${path} exceeds the maximum nesting depth`);
|
|
141
|
+
}
|
|
142
|
+
state.nodes++;
|
|
143
|
+
if (state.nodes > MAXIMUM_PREDICATE_NODES) {
|
|
144
|
+
throw new Error('SQL predicate exceeds the maximum node count');
|
|
145
|
+
}
|
|
146
|
+
if (!isRecord(value) || !hasExactKeys(value, ['op', 'args'])) {
|
|
147
|
+
throw new Error(`SQL predicate ${path} must contain only op and args`);
|
|
148
|
+
}
|
|
149
|
+
if (typeof value['op'] !== 'string' || !Array.isArray(value['args'])) {
|
|
150
|
+
throw new Error(`SQL predicate ${path} requires string op and array args`);
|
|
151
|
+
}
|
|
152
|
+
switch (value['op']) {
|
|
153
|
+
case 'and':
|
|
154
|
+
case 'or':
|
|
155
|
+
if (value['args'].length < 2) {
|
|
156
|
+
throw new Error(`SQL predicate ${path}.${value['op']} requires at least two arguments`);
|
|
157
|
+
}
|
|
158
|
+
for (let index = 0; index < value['args'].length; index++) {
|
|
159
|
+
validatePredicateNode(value['args'][index], `${path}.args[${index}]`, depth + 1, state);
|
|
160
|
+
}
|
|
161
|
+
return;
|
|
162
|
+
case 'not':
|
|
163
|
+
if (value['args'].length !== 1) {
|
|
164
|
+
throw new Error(`SQL predicate ${path}.not requires exactly one argument`);
|
|
165
|
+
}
|
|
166
|
+
validatePredicateNode(value['args'][0], `${path}.args[0]`, depth + 1, state);
|
|
167
|
+
return;
|
|
168
|
+
case 'isNull':
|
|
169
|
+
if (value['args'].length !== 1) {
|
|
170
|
+
throw new Error(`SQL predicate ${path}.isNull requires exactly one argument`);
|
|
171
|
+
}
|
|
172
|
+
validatePredicateProperty(value['args'][0], `${path}.args[0]`);
|
|
173
|
+
return;
|
|
174
|
+
case 'in':
|
|
175
|
+
if (value['args'].length !== 2 ||
|
|
176
|
+
!Array.isArray(value['args'][1]) ||
|
|
177
|
+
value['args'][1].length === 0) {
|
|
178
|
+
throw new Error(`SQL predicate ${path}.in requires a property and non-empty value list`);
|
|
179
|
+
}
|
|
180
|
+
validatePredicateProperty(value['args'][0], `${path}.args[0]`);
|
|
181
|
+
for (let index = 0; index < value['args'][1].length; index++) {
|
|
182
|
+
validatePredicateValue(value['args'][1][index], `${path}.args[1][${index}]`);
|
|
183
|
+
}
|
|
184
|
+
return;
|
|
185
|
+
case '=':
|
|
186
|
+
case '<>':
|
|
187
|
+
case '<':
|
|
188
|
+
case '<=':
|
|
189
|
+
case '>':
|
|
190
|
+
case '>=':
|
|
191
|
+
if (value['args'].length !== 2) {
|
|
192
|
+
throw new Error(`SQL predicate ${path}.${value['op']} requires exactly two arguments`);
|
|
193
|
+
}
|
|
194
|
+
validatePredicateProperty(value['args'][0], `${path}.args[0]`);
|
|
195
|
+
validatePredicateValue(value['args'][1], `${path}.args[1]`);
|
|
196
|
+
return;
|
|
197
|
+
default:
|
|
198
|
+
throw new Error(`SQL predicate ${path} has unsupported operator ${JSON.stringify(value['op'])}`);
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
/** Validates one property reference. */
|
|
202
|
+
function validatePredicateProperty(value, path) {
|
|
203
|
+
if (!isRecord(value) ||
|
|
204
|
+
!hasAllowedKeys(value, ['property', 'quoted', 'casts']) ||
|
|
205
|
+
typeof value['property'] !== 'string' ||
|
|
206
|
+
value['property'].length === 0 ||
|
|
207
|
+
(value['quoted'] !== undefined && typeof value['quoted'] !== 'boolean')) {
|
|
208
|
+
throw new Error(`SQL predicate ${path} requires a non-empty property reference`);
|
|
209
|
+
}
|
|
210
|
+
const casts = value['casts'];
|
|
211
|
+
if (casts !== undefined &&
|
|
212
|
+
(!Array.isArray(casts) ||
|
|
213
|
+
!casts.length ||
|
|
214
|
+
casts.length > 64 ||
|
|
215
|
+
Array.from(casts).some(type => !isColumnarScalarType(type))))
|
|
216
|
+
throw new Error(`SQL predicate ${path} has invalid casts`);
|
|
217
|
+
}
|
|
218
|
+
/** Validates one structured-cloneable predicate scalar. */
|
|
219
|
+
function validatePredicateValue(value, path) {
|
|
220
|
+
if (isSQLPredicateParameter(value)) {
|
|
221
|
+
return;
|
|
222
|
+
}
|
|
223
|
+
if (typeof value === 'boolean' ||
|
|
224
|
+
typeof value === 'bigint' ||
|
|
225
|
+
typeof value === 'string' ||
|
|
226
|
+
value instanceof Uint8Array) {
|
|
227
|
+
return;
|
|
228
|
+
}
|
|
229
|
+
if (typeof value === 'number' && Number.isFinite(value)) {
|
|
230
|
+
return;
|
|
231
|
+
}
|
|
232
|
+
if (value instanceof Date && Number.isFinite(value.getTime())) {
|
|
233
|
+
return;
|
|
234
|
+
}
|
|
235
|
+
throw new Error(`SQL predicate ${path} contains an unsupported scalar value`);
|
|
236
|
+
}
|
|
237
|
+
/** Returns whether an unknown value is a non-null object. */
|
|
238
|
+
function isRecord(value) {
|
|
239
|
+
return typeof value === 'object' && value !== null && !Array.isArray(value);
|
|
240
|
+
}
|
|
241
|
+
/** Returns whether an object contains exactly the expected enumerable keys. */
|
|
242
|
+
function hasExactKeys(value, expectedKeys) {
|
|
243
|
+
const keys = Object.keys(value);
|
|
244
|
+
return keys.length === expectedKeys.length && expectedKeys.every(key => keys.includes(key));
|
|
245
|
+
}
|
|
246
|
+
function hasAllowedKeys(value, allowedKeys) {
|
|
247
|
+
return Object.keys(value).every(key => allowedKeys.includes(key));
|
|
248
|
+
}
|
|
249
|
+
//# sourceMappingURL=sql-predicate-schema.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sql-predicate-schema.js","sourceRoot":"","sources":["../../src/parser/sql-predicate-schema.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import type { ColumnarScalarType } from "../expressions/scalar-type.js";
|
|
2
|
+
import { type ColumnarComparisonPredicate, type ColumnarInPredicate, type ColumnarLogicalPredicate, type ColumnarNotPredicate, type ColumnarNullPredicate, type ColumnarPredicate, type ColumnarPredicateInputValue, type ColumnarPredicateParameter, type ColumnarPredicateParameterValues, type ColumnarPredicateValue } from "../expressions/columnar-predicate.js";
|
|
3
|
+
/** Scalar values supported by portable SQL predicate expressions. */
|
|
4
|
+
export type SQLPredicateScalar = ColumnarPredicateValue;
|
|
5
|
+
/** Named parameter reference retained in a portable SQL predicate until execution time. */
|
|
6
|
+
export type SQLPredicateParameter = ColumnarPredicateParameter;
|
|
7
|
+
/** Scalar value or unresolved named parameter accepted by a portable predicate expression. */
|
|
8
|
+
export type SQLPredicateValue = ColumnarPredicateInputValue;
|
|
9
|
+
/** Runtime values used to bind named predicate parameters before a backend executes them. */
|
|
10
|
+
export type SQLPredicateParameterValues = ColumnarPredicateParameterValues;
|
|
11
|
+
/** Reference to one column in a portable SQL predicate expression. */
|
|
12
|
+
export type SQLPredicateProperty = Readonly<{
|
|
13
|
+
/** Column or qualified column name. */
|
|
14
|
+
property: string;
|
|
15
|
+
/** Whether the complete property was a quoted SQL identifier. */
|
|
16
|
+
quoted?: boolean;
|
|
17
|
+
/** Explicit conversions, applied in order before predicate comparison. */
|
|
18
|
+
casts?: readonly ColumnarScalarType[];
|
|
19
|
+
}>;
|
|
20
|
+
/** Binary comparison between a column and a scalar value. */
|
|
21
|
+
export type SQLComparisonPredicate = Readonly<ColumnarComparisonPredicate<SQLPredicateValue, SQLPredicateProperty>>;
|
|
22
|
+
/** Membership test between a column and scalar values. */
|
|
23
|
+
export type SQLInPredicate = Readonly<ColumnarInPredicate<SQLPredicateValue, SQLPredicateProperty>>;
|
|
24
|
+
/** Null test for one column. */
|
|
25
|
+
export type SQLNullPredicate = Readonly<ColumnarNullPredicate<SQLPredicateProperty>>;
|
|
26
|
+
/** Conjunction or disjunction of two or more predicates. */
|
|
27
|
+
export type SQLLogicalPredicate = Readonly<ColumnarLogicalPredicate<SQLPredicateValue, SQLPredicateProperty>>;
|
|
28
|
+
/** Negation of one predicate. */
|
|
29
|
+
export type SQLNotPredicate = Readonly<ColumnarNotPredicate<SQLPredicateValue, SQLPredicateProperty>>;
|
|
30
|
+
/**
|
|
31
|
+
* Portable predicate AST emitted by the math.gl SQL expression parser.
|
|
32
|
+
*
|
|
33
|
+
* The expression shape is directionally aligned with CQL2 JSON, but this deliberately small
|
|
34
|
+
* subset does not claim CQL2 conformance.
|
|
35
|
+
*/
|
|
36
|
+
export type SQLPredicate = SQLComparisonPredicate | SQLInPredicate | SQLNullPredicate | SQLLogicalPredicate | SQLNotPredicate;
|
|
37
|
+
/** Portable SQL predicate whose named parameters have all been replaced by concrete scalars. */
|
|
38
|
+
export type BoundSQLPredicate = ColumnarPredicate<SQLPredicateScalar, SQLPredicateProperty>;
|
|
39
|
+
/** Options for parsing one SQL predicate expression. */
|
|
40
|
+
export type SQLPredicateParserOptions = Readonly<{
|
|
41
|
+
/** Named values referenced using SQL parameters such as `:minimumFare`. */
|
|
42
|
+
parameters?: SQLPredicateParameterValues;
|
|
43
|
+
/** Retains named references in the emitted AST instead of resolving them while parsing. */
|
|
44
|
+
preserveParameters?: boolean;
|
|
45
|
+
}>;
|
|
46
|
+
/** Returns whether a value is a named parameter reference. */
|
|
47
|
+
export declare function isSQLPredicateParameter(value: unknown): value is SQLPredicateParameter;
|
|
48
|
+
//# sourceMappingURL=sql-predicate-types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"sql-predicate-types.d.ts","sourceRoot":"","sources":["../../src/parser/sql-predicate-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAC,sCAAmC;AAEnE,OAAO,EAEL,KAAK,2BAA2B,EAChC,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,gCAAgC,EACrC,KAAK,sBAAsB,EAC5B,6CAA0C;AAE3C,qEAAqE;AACrE,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAExD,2FAA2F;AAC3F,MAAM,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAE/D,8FAA8F;AAC9F,MAAM,MAAM,iBAAiB,GAAG,2BAA2B,CAAC;AAE5D,6FAA6F;AAC7F,MAAM,MAAM,2BAA2B,GAAG,gCAAgC,CAAC;AAE3E,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACvC,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAC3C,2BAA2B,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CACrE,CAAC;AAEF,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,mBAAmB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAAC,CAAC;AAEpG,gCAAgC;AAChC,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAErF,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAAG,QAAQ,CACxC,wBAAwB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAClE,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,eAAe,GAAG,QAAQ,CACpC,oBAAoB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,CAC9D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GACpB,sBAAsB,GACtB,cAAc,GACd,gBAAgB,GAChB,mBAAmB,GACnB,eAAe,CAAC;AAEpB,gGAAgG;AAChG,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;AAE5F,wDAAwD;AACxD,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,2EAA2E;IAC3E,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC,CAAC;AAEH,8DAA8D;AAC9D,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,qBAAqB,CAEtF"}
|