@loaders.gl/sql 5.0.0-alpha.1 → 5.0.0-alpha.10

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 (96) hide show
  1. package/LICENSE +14 -3
  2. package/README.md +107 -0
  3. package/dist/arrow-query.cjs +1404 -0
  4. package/dist/arrow-query.cjs.map +6 -0
  5. package/dist/arrow-query.d.ts +5 -0
  6. package/dist/arrow-query.d.ts.map +1 -0
  7. package/dist/arrow-query.js +6 -0
  8. package/dist/arrow-query.js.map +1 -0
  9. package/dist/arrow-table-source.d.ts +27 -0
  10. package/dist/arrow-table-source.d.ts.map +1 -0
  11. package/dist/arrow-table-source.js +79 -0
  12. package/dist/arrow-table-source.js.map +1 -0
  13. package/dist/bind-sql-predicate.d.ts +4 -0
  14. package/dist/bind-sql-predicate.d.ts.map +1 -0
  15. package/dist/bind-sql-predicate.js +11 -0
  16. package/dist/bind-sql-predicate.js.map +1 -0
  17. package/dist/compile-table-query.d.ts +55 -0
  18. package/dist/compile-table-query.d.ts.map +1 -0
  19. package/dist/compile-table-query.js +255 -0
  20. package/dist/compile-table-query.js.map +1 -0
  21. package/dist/duckdb-sql-source.d.ts +51 -3
  22. package/dist/duckdb-sql-source.d.ts.map +1 -1
  23. package/dist/duckdb-sql-source.js +21 -7
  24. package/dist/duckdb-sql-source.js.map +1 -1
  25. package/dist/index.cjs +3352 -37
  26. package/dist/index.cjs.map +3 -4
  27. package/dist/index.d.ts +16 -1
  28. package/dist/index.d.ts.map +1 -1
  29. package/dist/index.js +9 -0
  30. package/dist/index.js.map +1 -1
  31. package/dist/parse-sql-predicate.d.ts +10 -0
  32. package/dist/parse-sql-predicate.d.ts.map +1 -0
  33. package/dist/parse-sql-predicate.js +322 -0
  34. package/dist/parse-sql-predicate.js.map +1 -0
  35. package/dist/query-arrow-table.d.ts +83 -0
  36. package/dist/query-arrow-table.d.ts.map +1 -0
  37. package/dist/query-arrow-table.js +663 -0
  38. package/dist/query-arrow-table.js.map +1 -0
  39. package/dist/snowflake-sql-source.d.ts +51 -3
  40. package/dist/snowflake-sql-source.d.ts.map +1 -1
  41. package/dist/snowflake-sql-source.js +9 -6
  42. package/dist/snowflake-sql-source.js.map +1 -1
  43. package/dist/sql-predicate-schema.d.ts +156 -0
  44. package/dist/sql-predicate-schema.d.ts.map +1 -0
  45. package/dist/sql-predicate-schema.js +226 -0
  46. package/dist/sql-predicate-schema.js.map +1 -0
  47. package/dist/sql-predicate-types.d.ts +45 -0
  48. package/dist/sql-predicate-types.d.ts.map +1 -0
  49. package/dist/sql-predicate-types.js +9 -0
  50. package/dist/sql-predicate-types.js.map +1 -0
  51. package/dist/sql-predicate-zod.cjs +54 -0
  52. package/dist/sql-predicate-zod.cjs.map +6 -0
  53. package/dist/sql-predicate-zod.d.ts +11 -0
  54. package/dist/sql-predicate-zod.d.ts.map +1 -0
  55. package/dist/sql-predicate-zod.js +45 -0
  56. package/dist/sql-predicate-zod.js.map +1 -0
  57. package/dist/sql-predicate.cjs +607 -0
  58. package/dist/sql-predicate.cjs.map +6 -0
  59. package/dist/sql-predicate.d.ts +6 -0
  60. package/dist/sql-predicate.d.ts.map +1 -0
  61. package/dist/sql-predicate.js +8 -0
  62. package/dist/sql-predicate.js.map +1 -0
  63. package/dist/sql-source.d.ts +16 -3
  64. package/dist/sql-source.d.ts.map +1 -1
  65. package/dist/sql-source.js +34 -5
  66. package/dist/sql-source.js.map +1 -1
  67. package/dist/sql-types.d.ts +3 -0
  68. package/dist/sql-types.d.ts.map +1 -1
  69. package/dist/table-query-capabilities.d.ts +6 -0
  70. package/dist/table-query-capabilities.d.ts.map +1 -0
  71. package/dist/table-query-capabilities.js +26 -0
  72. package/dist/table-query-capabilities.js.map +1 -0
  73. package/dist/table-query.cjs +286 -0
  74. package/dist/table-query.cjs.map +6 -0
  75. package/dist/table-query.d.ts +29 -0
  76. package/dist/table-query.d.ts.map +1 -0
  77. package/dist/table-query.js +30 -0
  78. package/dist/table-query.js.map +1 -0
  79. package/package.json +45 -8
  80. package/src/arrow-query.ts +17 -0
  81. package/src/arrow-table-source.ts +111 -0
  82. package/src/bind-sql-predicate.ts +21 -0
  83. package/src/compile-table-query.ts +354 -0
  84. package/src/duckdb-sql-source.ts +30 -6
  85. package/src/index.ts +57 -0
  86. package/src/parse-sql-predicate.ts +381 -0
  87. package/src/query-arrow-table.ts +846 -0
  88. package/src/snowflake-sql-source.ts +8 -5
  89. package/src/sql-predicate-schema.ts +251 -0
  90. package/src/sql-predicate-types.ts +87 -0
  91. package/src/sql-predicate-zod.ts +52 -0
  92. package/src/sql-predicate.ts +28 -0
  93. package/src/sql-source.ts +40 -5
  94. package/src/sql-types.ts +4 -0
  95. package/src/table-query-capabilities.ts +29 -0
  96. package/src/table-query.ts +78 -0
@@ -0,0 +1,322 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // Copyright (c) vis.gl contributors
4
+ import { validateSQLPredicate } from "./sql-predicate-schema.js";
5
+ const MAXIMUM_SQL_LENGTH = 65_536;
6
+ const MAXIMUM_SQL_TOKENS = 4096;
7
+ const MAXIMUM_EXPRESSION_DEPTH = 64;
8
+ /**
9
+ * Parses a small SQL `WHERE` expression into a portable CQL2-shaped predicate AST.
10
+ *
11
+ * Supported syntax is limited to comparisons, `IN`, `IS [NOT] NULL`, `AND`, `OR`, `NOT`, named
12
+ * parameters, scalar literals, and parentheses. The input is the expression after `WHERE`, not a
13
+ * complete `SELECT` statement.
14
+ */
15
+ export function parseSQLPredicate(source, options = {}) {
16
+ const parser = new SQLPredicateParser(source, options.parameters ?? {}, options.preserveParameters === true);
17
+ const predicate = parser.parse();
18
+ validateSQLPredicate(predicate);
19
+ return predicate;
20
+ }
21
+ /** Dependency-free recursive-descent parser for one SQL predicate expression. */
22
+ class SQLPredicateParser {
23
+ /** Token stream parsed by this parser instance. */
24
+ tokens;
25
+ /** Named scalar parameters available to the expression. */
26
+ parameters;
27
+ /** Whether named parameters remain references in the parsed AST. */
28
+ preserveParameters;
29
+ /** Current index in the token stream. */
30
+ position = 0;
31
+ constructor(source, parameters, preserveParameters) {
32
+ this.tokens = tokenizeSQLPredicate(source);
33
+ this.parameters = parameters;
34
+ this.preserveParameters = preserveParameters;
35
+ }
36
+ /** Parses the complete token stream. */
37
+ parse() {
38
+ const predicate = this.parseOr(0);
39
+ this.takeSymbol(';');
40
+ const token = this.peek();
41
+ if (token) {
42
+ throw new Error(`SQL predicate contains unexpected token ${JSON.stringify(token.value)}`);
43
+ }
44
+ return predicate;
45
+ }
46
+ /** Parses left-associative disjunction. */
47
+ parseOr(depth) {
48
+ let predicate = this.parseAnd(depth + 1);
49
+ while (this.takeKeyword('OR')) {
50
+ predicate = combineLogicalPredicate('or', predicate, this.parseAnd(depth + 1));
51
+ }
52
+ return predicate;
53
+ }
54
+ /** Parses left-associative conjunction. */
55
+ parseAnd(depth) {
56
+ let predicate = this.parseNot(depth + 1);
57
+ while (this.takeKeyword('AND')) {
58
+ predicate = combineLogicalPredicate('and', predicate, this.parseNot(depth + 1));
59
+ }
60
+ return predicate;
61
+ }
62
+ /** Parses boolean negation and parenthesized predicates. */
63
+ parseNot(depth) {
64
+ this.assertDepth(depth);
65
+ if (this.takeKeyword('NOT')) {
66
+ return { op: 'not', args: [this.parseNot(depth + 1)] };
67
+ }
68
+ if (this.takeSymbol('(')) {
69
+ const predicate = this.parseOr(depth + 1);
70
+ this.expectSymbol(')');
71
+ return predicate;
72
+ }
73
+ return this.parseLeaf();
74
+ }
75
+ /** Parses one comparison, membership, or null predicate. */
76
+ parseLeaf() {
77
+ const property = this.parseProperty();
78
+ if (this.takeKeyword('IS')) {
79
+ const negated = this.takeKeyword('NOT');
80
+ this.expectKeyword('NULL');
81
+ const predicate = { op: 'isNull', args: [property] };
82
+ return negated ? { op: 'not', args: [predicate] } : predicate;
83
+ }
84
+ const negatedMembership = this.takeKeyword('NOT');
85
+ if (negatedMembership || this.peekKeyword('IN')) {
86
+ this.expectKeyword('IN');
87
+ this.expectSymbol('(');
88
+ if (this.peek()?.kind === 'symbol' && this.peek()?.value === ')') {
89
+ throw new Error('SQL predicate IN requires at least one scalar value');
90
+ }
91
+ const values = [this.parseValue()];
92
+ while (this.takeSymbol(',')) {
93
+ values.push(this.parseValue());
94
+ }
95
+ this.expectSymbol(')');
96
+ const predicate = { op: 'in', args: [property, values] };
97
+ return negatedMembership ? { op: 'not', args: [predicate] } : predicate;
98
+ }
99
+ const token = this.take();
100
+ if (token?.kind !== 'symbol' ||
101
+ !['=', '!=', '<>', '<', '<=', '>', '>='].includes(token.value)) {
102
+ throw new Error('SQL predicate expected a comparison, IN, or IS NULL operator');
103
+ }
104
+ const operator = token.value === '!=' ? '<>' : token.value;
105
+ return {
106
+ op: operator,
107
+ args: [property, this.parseValue()]
108
+ };
109
+ }
110
+ /** Parses an identifier into a property reference. */
111
+ parseProperty() {
112
+ const token = this.take();
113
+ if (token?.kind !== 'identifier') {
114
+ throw new Error('SQL predicate expected a column identifier');
115
+ }
116
+ return token.quoted ? { property: token.value, quoted: true } : { property: token.value };
117
+ }
118
+ /** Parses one scalar literal or named parameter. */
119
+ parseValue() {
120
+ const negative = this.takeSymbol('-');
121
+ const token = this.take();
122
+ if (!token) {
123
+ throw new Error('SQL predicate expected a scalar value');
124
+ }
125
+ if (negative && token.kind !== 'number') {
126
+ throw new Error('SQL predicate only permits unary minus on numeric literals');
127
+ }
128
+ if (token.kind === 'number') {
129
+ return parseNumericLiteral(negative ? `-${token.value}` : token.value);
130
+ }
131
+ if (negative) {
132
+ throw new Error('SQL predicate expected a numeric literal after unary minus');
133
+ }
134
+ if (token.kind === 'string') {
135
+ return token.value;
136
+ }
137
+ if (token.kind === 'parameter') {
138
+ if (this.preserveParameters) {
139
+ return { parameter: token.value };
140
+ }
141
+ if (!Object.hasOwn(this.parameters, token.value)) {
142
+ throw new Error(`SQL predicate parameter ":${token.value}" requires a value`);
143
+ }
144
+ const value = this.parameters[token.value];
145
+ validateParameterValue(value, token.value);
146
+ return value;
147
+ }
148
+ if (token.kind === 'identifier' && /^(TRUE|FALSE)$/i.test(token.value)) {
149
+ return /^TRUE$/i.test(token.value);
150
+ }
151
+ if (token.kind === 'identifier' && /^NULL$/i.test(token.value)) {
152
+ throw new Error('SQL predicate comparisons with NULL must use IS NULL or IS NOT NULL');
153
+ }
154
+ throw new Error(`SQL predicate does not support scalar token ${JSON.stringify(token.value)}`);
155
+ }
156
+ /** Rejects excessively nested inputs before recursion can exhaust the stack. */
157
+ assertDepth(depth) {
158
+ if (depth > MAXIMUM_EXPRESSION_DEPTH) {
159
+ throw new Error('SQL predicate nesting exceeds its safe limit');
160
+ }
161
+ }
162
+ /** Consumes one required keyword. */
163
+ expectKeyword(keyword) {
164
+ if (!this.takeKeyword(keyword)) {
165
+ throw new Error(`SQL predicate expected ${keyword}`);
166
+ }
167
+ }
168
+ /** Returns whether the next token is a keyword without consuming it. */
169
+ peekKeyword(keyword) {
170
+ const token = this.peek();
171
+ return token?.kind === 'identifier' && token.value.toUpperCase() === keyword;
172
+ }
173
+ /** Consumes one optional keyword. */
174
+ takeKeyword(keyword) {
175
+ if (!this.peekKeyword(keyword)) {
176
+ return false;
177
+ }
178
+ this.position++;
179
+ return true;
180
+ }
181
+ /** Consumes one required symbol. */
182
+ expectSymbol(symbol) {
183
+ if (!this.takeSymbol(symbol)) {
184
+ throw new Error(`SQL predicate expected ${JSON.stringify(symbol)}`);
185
+ }
186
+ }
187
+ /** Consumes one optional symbol. */
188
+ takeSymbol(symbol) {
189
+ const token = this.peek();
190
+ if (token?.kind !== 'symbol' || token.value !== symbol) {
191
+ return false;
192
+ }
193
+ this.position++;
194
+ return true;
195
+ }
196
+ /** Consumes and returns the next token. */
197
+ take() {
198
+ const token = this.tokens[this.position];
199
+ if (token) {
200
+ this.position++;
201
+ }
202
+ return token;
203
+ }
204
+ /** Returns the next token without consuming it. */
205
+ peek() {
206
+ return this.tokens[this.position];
207
+ }
208
+ }
209
+ /** Flattens adjacent equal logical operators into one CQL2-shaped node. */
210
+ function combineLogicalPredicate(operator, left, right) {
211
+ return left.op === operator
212
+ ? { op: operator, args: [...left.args, right] }
213
+ : { op: operator, args: [left, right] };
214
+ }
215
+ /** Converts a bounded SQL numeric token to a number or exact bigint. */
216
+ function parseNumericLiteral(source) {
217
+ if (/^-?\d+$/.test(source)) {
218
+ const bigint = BigInt(source);
219
+ if (bigint > BigInt(Number.MAX_SAFE_INTEGER) || bigint < BigInt(Number.MIN_SAFE_INTEGER)) {
220
+ return bigint;
221
+ }
222
+ }
223
+ const number = Number(source);
224
+ if (!Number.isFinite(number)) {
225
+ throw new Error('SQL predicate numeric literals must be finite');
226
+ }
227
+ return number;
228
+ }
229
+ /** Validates one named parameter at its parser boundary. */
230
+ function validateParameterValue(value, name) {
231
+ const probe = { op: '=', args: [{ property: '_' }, value] };
232
+ try {
233
+ validateSQLPredicate(probe);
234
+ }
235
+ catch {
236
+ throw new Error(`SQL predicate parameter ":${name}" has an unsupported value`);
237
+ }
238
+ }
239
+ /** Tokenizes a safely bounded SQL predicate expression. */
240
+ function tokenizeSQLPredicate(source) {
241
+ if (typeof source !== 'string' ||
242
+ source.trim().length === 0 ||
243
+ source.length > MAXIMUM_SQL_LENGTH) {
244
+ throw new Error('SQL predicate requires a non-empty, safely bounded expression');
245
+ }
246
+ const tokens = [];
247
+ let position = 0;
248
+ while (position < source.length) {
249
+ const character = source[position];
250
+ if (/\s/.test(character)) {
251
+ position++;
252
+ continue;
253
+ }
254
+ if (character === "'") {
255
+ const result = readQuotedToken(source, position, "'", "'");
256
+ tokens.push({ kind: 'string', value: result.value });
257
+ position = result.position;
258
+ }
259
+ else if (character === '"') {
260
+ const result = readQuotedToken(source, position, '"', '"');
261
+ tokens.push({ kind: 'identifier', value: result.value, quoted: true });
262
+ position = result.position;
263
+ }
264
+ else if (character === ':') {
265
+ const match = /^[A-Za-z_][A-Za-z0-9_]*/.exec(source.slice(position + 1));
266
+ if (!match) {
267
+ throw new Error(`SQL predicate contains an invalid parameter at character ${position}`);
268
+ }
269
+ tokens.push({ kind: 'parameter', value: match[0] });
270
+ position += match[0].length + 1;
271
+ }
272
+ else {
273
+ const numberMatch = /^(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?/.exec(source.slice(position));
274
+ const identifierMatch = /^[A-Za-z_][A-Za-z0-9_]*(?:\.[A-Za-z_][A-Za-z0-9_]*)*/.exec(source.slice(position));
275
+ if (numberMatch) {
276
+ tokens.push({ kind: 'number', value: numberMatch[0] });
277
+ position += numberMatch[0].length;
278
+ }
279
+ else if (identifierMatch) {
280
+ tokens.push({ kind: 'identifier', value: identifierMatch[0] });
281
+ position += identifierMatch[0].length;
282
+ }
283
+ else {
284
+ const twoCharacters = source.slice(position, position + 2);
285
+ if (['<=', '>=', '<>', '!='].includes(twoCharacters)) {
286
+ tokens.push({ kind: 'symbol', value: twoCharacters });
287
+ position += 2;
288
+ }
289
+ else if ('(),;-=<>'.includes(character)) {
290
+ tokens.push({ kind: 'symbol', value: character });
291
+ position++;
292
+ }
293
+ else {
294
+ throw new Error(`SQL predicate contains an unsupported token at character ${position}`);
295
+ }
296
+ }
297
+ }
298
+ if (tokens.length > MAXIMUM_SQL_TOKENS) {
299
+ throw new Error('SQL predicate exceeds its safe token limit');
300
+ }
301
+ }
302
+ return tokens;
303
+ }
304
+ /** Reads one SQL string or quoted identifier with doubled-quote escaping. */
305
+ function readQuotedToken(source, start, quote, escapedQuote) {
306
+ let value = '';
307
+ let position = start + 1;
308
+ while (position < source.length) {
309
+ if (source[position] !== quote) {
310
+ value += source[position++];
311
+ continue;
312
+ }
313
+ if (source[position + 1] === escapedQuote) {
314
+ value += quote;
315
+ position += 2;
316
+ continue;
317
+ }
318
+ return { value, position: position + 1 };
319
+ }
320
+ throw new Error(`SQL predicate contains an unterminated quoted value at character ${start}`);
321
+ }
322
+ //# sourceMappingURL=parse-sql-predicate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"parse-sql-predicate.js","sourceRoot":"","sources":["../src/parse-sql-predicate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ import type { ArrowTable } from '@loaders.gl/schema';
2
+ import { type TableQueryOptions } from "./table-query.js";
3
+ import type { RelationalAggregate, RelationalExpression, RelationalOrderKey } from '@loaders.gl/loader-utils';
4
+ import { ARROW_TABLE_QUERY_CAPABILITIES } from "./table-query-capabilities.js";
5
+ export { ARROW_TABLE_QUERY_CAPABILITIES };
6
+ /** A named child relation using the SQL module's property-oriented predicate AST. */
7
+ type ArrowChildQuery = Readonly<{
8
+ /** Logical source name resolved through the query's table map. */
9
+ source: string;
10
+ /** Optional query applied to the child relation before combining it. */
11
+ query?: TableQueryOptions;
12
+ }>;
13
+ /** Options for the lightweight in-memory Arrow query executor. */
14
+ export type ArrowQueryOptions = TableQueryOptions & Readonly<{
15
+ /** Cancels the query before or during predicate evaluation. */
16
+ signal?: AbortSignal;
17
+ /** Computed columns evaluated before ordering and projection. */
18
+ expressions?: readonly RelationalExpression[];
19
+ /** Stable ordering applied before the global limit. */
20
+ orderBy?: readonly RelationalOrderKey[];
21
+ /** Grouping keys and aggregate definitions for relational output. */
22
+ groupBy?: readonly string[];
23
+ /** Aggregate definitions evaluated after filtering and expressions. */
24
+ aggregates?: readonly RelationalAggregate[];
25
+ /** Additional Arrow tables concatenated in source order before relational operators. */
26
+ union?: readonly ArrowChildQuery[];
27
+ /** Optional equi-join against a table supplied in `tables`. */
28
+ join?: Readonly<{
29
+ child: ArrowChildQuery;
30
+ left: string;
31
+ right: string;
32
+ }>;
33
+ /** Named in-memory child tables used by union and join operators. */
34
+ tables?: Readonly<Record<string, ArrowTable>>;
35
+ }>;
36
+ /** Explains an Arrow table query without materializing or scanning table rows. */
37
+ export declare function explainArrowTableQuery(sourceTable: ArrowTable, options?: ArrowQueryOptions): Readonly<{
38
+ sourceColumns: readonly string[];
39
+ outputColumns: readonly string[];
40
+ requiredColumns: readonly string[];
41
+ predicateColumns: readonly string[];
42
+ plan: import("@loaders.gl/loader-utils").TableQueryPlan<Readonly<import("@loaders.gl/loader-utils").ColumnarComparisonPredicate<import("@loaders.gl/loader-utils").ColumnarPredicateInputValue, Readonly<{
43
+ property: string;
44
+ quoted?: boolean;
45
+ }>>> | Readonly<import("@loaders.gl/loader-utils").ColumnarInPredicate<import("@loaders.gl/loader-utils").ColumnarPredicateInputValue, Readonly<{
46
+ property: string;
47
+ quoted?: boolean;
48
+ }>>> | Readonly<import("@loaders.gl/loader-utils").ColumnarNullPredicate<Readonly<{
49
+ property: string;
50
+ quoted?: boolean;
51
+ }>>> | Readonly<import("@loaders.gl/loader-utils").ColumnarLogicalPredicate<import("@loaders.gl/loader-utils").ColumnarPredicateInputValue, Readonly<{
52
+ property: string;
53
+ quoted?: boolean;
54
+ }>>> | Readonly<import("@loaders.gl/loader-utils").ColumnarNotPredicate<import("@loaders.gl/loader-utils").ColumnarPredicateInputValue, Readonly<{
55
+ property: string;
56
+ quoted?: boolean;
57
+ }>>>>;
58
+ capabilities: Readonly<{
59
+ projection: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
60
+ predicate: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
61
+ limit: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
62
+ streaming: boolean;
63
+ cancellation: boolean;
64
+ expressions?: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
65
+ orderBy?: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
66
+ aggregates?: import("@loaders.gl/loader-utils").TableQueryOperatorSupport;
67
+ }>;
68
+ operators: Readonly<{
69
+ projection: import("@loaders.gl/loader-utils").TableQueryExplainOperator;
70
+ predicate: import("@loaders.gl/loader-utils").TableQueryExplainOperator;
71
+ limit: import("@loaders.gl/loader-utils").TableQueryExplainOperator;
72
+ }>;
73
+ }>;
74
+ /**
75
+ * Executes a small, Arrow-native query over one in-memory table.
76
+ *
77
+ * The proof of concept supports portable predicates, column projection, and limits. Projection
78
+ * and limits without a predicate preserve Arrow's zero-copy views. Predicate evaluation is
79
+ * currently row-oriented and materializes the matching result rows; later physical operators can
80
+ * replace this implementation with vectorized selection handling without changing this API.
81
+ */
82
+ export declare function queryArrowTable(sourceTable: ArrowTable, options?: ArrowQueryOptions): ArrowTable;
83
+ //# sourceMappingURL=query-arrow-table.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query-arrow-table.d.ts","sourceRoot":"","sources":["../src/query-arrow-table.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAC,UAAU,EAAC,MAAM,oBAAoB,CAAC;AAcnD,OAAO,EAKL,KAAK,iBAAiB,EAIvB,yBAAsB;AACvB,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAKlC,OAAO,EAAC,8BAA8B,EAAC,sCAAmC;AAE1E,OAAO,EAAC,8BAA8B,EAAC,CAAC;AAExC,qFAAqF;AACrF,KAAK,eAAe,GAAG,QAAQ,CAAC;IAC9B,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,KAAK,CAAC,EAAE,iBAAiB,CAAC;CAC3B,CAAC,CAAC;AAEH,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAC/C,QAAQ,CAAC;IACP,+DAA+D;IAC/D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iEAAiE;IACjE,WAAW,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC9C,uDAAuD;IACvD,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACxC,qEAAqE;IACrE,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,uEAAuE;IACvE,UAAU,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC5C,wFAAwF;IACxF,KAAK,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IACnC,+DAA+D;IAC/D,IAAI,CAAC,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,eAAe,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAC,CAAC,CAAC;IACvE,qEAAqE;IACrE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;CAC/C,CAAC,CAAC;AAEL,kFAAkF;AAClF,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,UAAU,EAAE,OAAO,GAAE,iBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAS9F;AAID;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,UAAU,EACvB,OAAO,GAAE,iBAAsB,GAC9B,UAAU,CA0DZ"}