@uwdata/mosaic-sql 0.17.0 → 0.18.0

package/{src → dist/src}/util/ast.js

@@ -1,7 +1,3 @@
-/**
- * @import { ColumnRefNode } from '../ast/column-ref.js'
- * @import { TableRefNode } from '../ast/table-ref.js'
- */
 import { ExprNode } from '../ast/node.js';
 import { ParamNode } from '../ast/param.js';
 import { WindowDefNode } from '../ast/window.js';
@@ -10,90 +6,89 @@ import { literal, verbatim } from '../functions/literal.js';
 import { tableRef } from '../functions/table-ref.js';
 import { parseIdentifier } from './string.js';
 import { isArray, isParamLike, isString } from './type-check.js';
-
 /**
  * Interpret a value as a SQL AST node. String values are assumed to be
  * column references. All other primitive values are interpreted as
  * SQL literals. Dynamic parameters are interpreted as param AST nodes,
  * while existing AST nodes are left as-is.
- * @param {*} value The value to interpret as a SQL AST node.
- * @returns {ExprNode}
+ * @param value The value to interpret as a SQL AST node.
  */
 export function asNode(value) {
-  return isString(value)
-    ? parseColumnRef(value)
-    : asLiteral(value);
+    return isString(value)
+        ? parseColumnRef(value)
+        : asLiteral(value);
 }
-
 /**
  * Interpret a value as a verbatim SQL AST node. String values will be
  * passed through to queries as verbatim text. All other primitive values
  * are interpreted as SQL literals. Dynamic parameters are interpreted
  * as param AST nodes, while existing AST nodes are left as-is.
- * @param {*} value The value to interpret as a verbatim AST node.
- * @returns {ExprNode}
+ * @param value The value to interpret as a verbatim AST node.
  */
 export function asVerbatim(value) {
-  return isString(value)
-    ? verbatim(value)
-    : asLiteral(value);
+    return isString(value)
+        ? verbatim(value)
+        : asLiteral(value);
 }
-
 /**
  * Interpret a value as a literal AST node. All other primitive values
  * are interpreted as SQL literals. Dynamic parameters are interpreted
  * as param AST nodes, while existing AST nodes are left as-is.
- * @param {*} value The value to interpret as a literal AST node.
- * @returns {ExprNode}
+ * @param value The value to interpret as a literal AST node.
  */
 export function asLiteral(value) {
-  return value instanceof ExprNode ? value
-    : isParamLike(value) ? new ParamNode(value)
-    : literal(value);
+    return value instanceof ExprNode ? value
+        : isParamLike(value) ? new ParamNode(value)
+            : literal(value);
 }
-
 /**
  * Interpret a value as a table reference AST node. String values are parsed
  * assuming dot ('.') delimiters (as in `schema.table`). Array values are
  * interpreted as pre-parsed name paths (as in `['schema', 'table']`). Any
  * other values are left as-is.
- * @param {string | string[] | TableRefNode} value The value to interpret as a
- *  table reference AST node.
- * @returns {TableRefNode}
+ * @param value The value to interpret as a table reference AST node.
  */
 export function asTableRef(value) {
-  return isString(value) ? parseTableRef(value)
-    : isArray(value) ? tableRef(value)
-    : value;
+    return getTableRef(value);
+}
+/**
+ * Try to interpret a value as a table reference AST node. String values are
+ * parsed assuming dot ('.') delimiters (as in `schema.table`). Array values
+ * are interpreted as pre-parsed name paths (as in `['schema', 'table']`). Any
+ * other values are left as-is.
+ * @param value The value to interpret as a table reference.
+ */
+export function maybeTableRef(value) {
+    return getTableRef(value);
+}
+function getTableRef(value) {
+    return isString(value) ? parseTableRef(value)
+        : isArray(value) ? tableRef(value)
+            : value;
 }
-
 /**
  * Parse a string as a column reference, potentially with
  * dot ('.') delimited table, schema, and database references.
- * @param {string} ref The column reference string.
- * @returns {ColumnRefNode}
+ * @param ref The column reference string.
  */
 export function parseColumnRef(ref) {
-  const ids = parseIdentifier(ref);
-  return column(ids.pop(), tableRef(ids));
+    const ids = parseIdentifier(ref);
+    return column(ids.pop(), tableRef(ids));
 }
-
 /**
  * Parse a string as a table reference, potentially with
  * dot ('.') delimited schema and database references.
- * @param {string} ref The table reference string.
- * @returns {TableRefNode}
+ * @param ref The table reference string.
  */
 export function parseTableRef(ref) {
-  return tableRef(parseIdentifier(ref));
+    return tableRef(parseIdentifier(ref));
 }
-
 /**
  * Create a new window definition node. The return value is an empty
  * window definition. Use chained calls such as `partitionby` and `orderby`
  * to specify the window settings.
- * @returns {WindowDefNode}
  */
 export function over() {
-  return new WindowDefNode();
+    return new WindowDefNode();
 }
+//# sourceMappingURL=ast.js.map

package/dist/src/util/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../../../src/util/ast.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAgB,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,QAAQ,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC;QACvB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,QAAQ,CAAC,KAAK,CAAC;QACpB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;QACjB,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,KAAK,YAAY,QAAQ,CAAC,CAAC,CAAC,KAAK;QACtC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,KAAK,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACrB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,KAAwC;IACjE,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAkC;IAC9D,OAAO,WAAW,CAAC,KAAK,CAAE,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAAI,KAA6B;IACnD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC;QAC3C,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAE;YACnC,CAAC,CAAC,KAAK,CAAC;AACZ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,EAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,CAAE,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,IAAI;IAClB,OAAO,IAAI,aAAa,EAAE,CAAC;AAC7B,CAAC"}

package/dist/src/util/function.d.ts

@@ -0,0 +1,56 @@
+import type { ExprNode, SQLNode } from '../ast/node.js';
+import type { WindowFunctionName } from '../types.js';
+import { AggregateNode } from '../ast/aggregate.js';
+import { FunctionNode } from '../ast/function.js';
+import { WindowNode } from '../ast/window.js';
+/**
+ * Test if an AST node is a specific function call.
+ * @param node The SQL AST node to test.
+ * @param name The function name.
+ */
+export declare function isFunctionCall(node: SQLNode, name: string): node is FunctionNode;
+/**
+ * Create a new function call AST node.
+ * @param name The function name.
+ * @param args The function arguments.
+ */
+export declare function fn(name: string, ...args: unknown[]): FunctionNode;
+/**
+ * Create a new aggregate function AST node.
+ * @param name The function name.
+ * @param args The function arguments.
+ */
+export declare function aggFn(name: string, ...args: unknown[]): AggregateNode;
+/**
+ * Create a new window AST node. The output node has an empty window
+ * definition. Use chained calls such as `partitionby` and `orderby`
+ * to specify the window settings.
+ * @param name The function name.
+ * @param args The function arguments.
+ */
+export declare function winFn(name: WindowFunctionName, ...args: unknown[]): WindowNode;
+/**
+ * Process a list of expression inputs. Nested arrays are flattened,
+ * null results are removed, and each input is cast to a SQL AST node.
+ * @param list The list of expression inputs.
+ * @param cast A function that casts an input value
+ *  to a desired type. By default, `asNode` is used to coerce
+ *  inputs to AST nodes as needed.
+ */
+export declare function exprList<T>(list: unknown[], cast: ((x: unknown) => T)): T[];
+/**
+ * Process a list of expression inputs. Nested arrays are flattened,
+ * null results are removed, and each input is cast (as needed) to
+ * be a proper SQL AST node. By default, strings are assumed to be
+ * column names, while other primitive values map to SQL literals.
+ * Use an alternative *cast* function to change this behavior.
+ * @param list The list of expression inputs.
+ */
+export declare function nodeList(list: unknown[]): ExprNode[];
+/**
+ * Process a list of function arguments, stripping any undefined
+ * values from the end of the list.
+ * @param list The input function arguments.
+ */
+export declare function argsList<T>(list: T[]): T[];
+//# sourceMappingURL=function.d.ts.map

package/dist/src/util/function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../../src/util/function.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAsB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGlE;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,MAAM,GACX,IAAI,IAAI,YAAY,CAEtB;AAED;;;;GAIG;AACH,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,YAAY,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,aAAa,CAErE;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CACnB,IAAI,EAAE,kBAAkB,EACxB,GAAG,IAAI,EAAE,OAAO,EAAE,GACjB,UAAU,CAIZ;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EACxB,IAAI,EAAE,OAAO,EAAE,EACf,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,GACxB,CAAC,EAAE,CAEL;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAK1C"}

package/dist/src/util/function.js

@@ -0,0 +1,73 @@
+import { AggregateNode } from '../ast/aggregate.js';
+import { FunctionNode } from '../ast/function.js';
+import { WindowFunctionNode, WindowNode } from '../ast/window.js';
+import { asNode } from './ast.js';
+/**
+ * Test if an AST node is a specific function call.
+ * @param node The SQL AST node to test.
+ * @param name The function name.
+ */
+export function isFunctionCall(node, name) {
+    return node instanceof FunctionNode && node.name === name;
+}
+/**
+ * Create a new function call AST node.
+ * @param name The function name.
+ * @param args The function arguments.
+ */
+export function fn(name, ...args) {
+    return new FunctionNode(name, argsList(args).map(asNode));
+}
+/**
+ * Create a new aggregate function AST node.
+ * @param name The function name.
+ * @param args The function arguments.
+ */
+export function aggFn(name, ...args) {
+    return new AggregateNode(name, argsList(args).map(asNode));
+}
+/**
+ * Create a new window AST node. The output node has an empty window
+ * definition. Use chained calls such as `partitionby` and `orderby`
+ * to specify the window settings.
+ * @param name The function name.
+ * @param args The function arguments.
+ */
+export function winFn(name, ...args) {
+    return new WindowNode(new WindowFunctionNode(name, argsList(args).map(asNode)));
+}
+/**
+ * Process a list of expression inputs. Nested arrays are flattened,
+ * null results are removed, and each input is cast to a SQL AST node.
+ * @param list The list of expression inputs.
+ * @param cast A function that casts an input value
+ *  to a desired type. By default, `asNode` is used to coerce
+ *  inputs to AST nodes as needed.
+ */
+export function exprList(list, cast) {
+    return list.flat().filter(x => x != null).map(x => cast(x));
+}
+/**
+ * Process a list of expression inputs. Nested arrays are flattened,
+ * null results are removed, and each input is cast (as needed) to
+ * be a proper SQL AST node. By default, strings are assumed to be
+ * column names, while other primitive values map to SQL literals.
+ * Use an alternative *cast* function to change this behavior.
+ * @param list The list of expression inputs.
+ */
+export function nodeList(list) {
+    return exprList(list, asNode);
+}
+/**
+ * Process a list of function arguments, stripping any undefined
+ * values from the end of the list.
+ * @param list The input function arguments.
+ */
+export function argsList(list) {
+    const n = list.length;
+    let i = n;
+    for (; i > 0 && list[i - 1] === undefined; --i)
+        ;
+    return i < n ? list.slice(0, i) : list;
+}
+//# sourceMappingURL=function.js.map

package/dist/src/util/function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../../src/util/function.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAa,EACb,IAAY;IAEZ,OAAO,IAAI,YAAY,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,EAAE,CAAC,IAAY,EAAE,GAAG,IAAe;IACjD,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,GAAG,IAAe;IACpD,OAAO,IAAI,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CACnB,IAAwB,EACxB,GAAG,IAAe;IAElB,OAAO,IAAI,UAAU,CACnB,IAAI,kBAAkB,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CACzD,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAe,EACf,IAAyB;IAEzB,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAe;IACtC,OAAO,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAI,IAAS;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;IACtB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,EAAE,EAAE,CAAC;QAAC,CAAC;IAChD,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC"}

package/dist/src/util/identity.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Identity function.
+ * @param x
+ */
+export declare function identity<T>(x: T): T;
+//# sourceMappingURL=identity.d.ts.map

package/dist/src/util/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../../src/util/identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,KAE/B"}

package/dist/src/util/identity.js

@@ -0,0 +1,8 @@
+/**
+ * Identity function.
+ * @param x
+ */
+export function identity(x) {
+    return x;
+}
+//# sourceMappingURL=identity.js.map

package/dist/src/util/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../../src/util/identity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAI,CAAI;IAC9B,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/src/util/string.d.ts

@@ -0,0 +1,4 @@
+export declare function parseIdentifier(id: string): string[];
+export declare function quoteIdentifier(value: unknown): string;
+export declare function unquote(s?: string): string | undefined;
+//# sourceMappingURL=string.d.ts.map

package/dist/src/util/string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../src/util/string.ts"],"names":[],"mappings":"AACA,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,YAEzC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,UAE7C;AAED,wBAAgB,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,sBAEjC"}

package/dist/src/util/string.js

@@ -0,0 +1,14 @@
+// TODO: handle case where identifiers are already quoted?
+export function parseIdentifier(id) {
+    return id.split('.');
+}
+export function quoteIdentifier(value) {
+    return `"${value}"`;
+}
+export function unquote(s) {
+    return s && isDoubleQuoted(s) ? s.slice(1, -1) : s;
+}
+function isDoubleQuoted(s) {
+    return s[0] === '"' && s[s.length - 1] === '"';
+}
+//# sourceMappingURL=string.js.map

package/dist/src/util/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../src/util/string.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,IAAI,KAAK,GAAG,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,CAAU;IAChC,OAAO,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,cAAc,CAAC,CAAS;IAC/B,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAC,CAAC,CAAC,KAAK,GAAG,CAAC;AAC/C,CAAC"}

package/dist/src/util/type-check.d.ts

@@ -0,0 +1,17 @@
+import type { ParamLike } from '../types.js';
+/**
+ * Check if a value is a string.
+ * @param value The value to check.
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Check if a value is an array.
+ * @param value The value to check.
+ */
+export declare function isArray(value: unknown): value is Array<unknown>;
+/**
+ * Check if a value is a dynamic parameter.
+ * @param value The value to check.
+ */
+export declare function isParamLike(value: unknown): value is ParamLike;
+//# sourceMappingURL=type-check.d.ts.map

package/dist/src/util/type-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-check.d.ts","sourceRoot":"","sources":["../../../src/util/type-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAE/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,SAAS,CAQ9D"}

package/dist/src/util/type-check.js

@@ -0,0 +1,28 @@
+/**
+ * Check if a value is a string.
+ * @param value The value to check.
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Check if a value is an array.
+ * @param value The value to check.
+ */
+export function isArray(value) {
+    return Array.isArray(value);
+}
+/**
+ * Check if a value is a dynamic parameter.
+ * @param value The value to check.
+ */
+export function isParamLike(value) {
+    if (value) {
+        const v = value;
+        return typeof v?.addEventListener === 'function'
+            && v.dynamic !== false
+            && 'value' in v;
+    }
+    return false;
+}
+//# sourceMappingURL=type-check.js.map

package/dist/src/util/type-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-check.js","sourceRoot":"","sources":["../../../src/util/type-check.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,CAAC,GAAG,KAA+B,CAAC;QAC1C,OAAO,OAAO,CAAC,EAAE,gBAAgB,KAAK,UAAU;eAC3C,CAAC,CAAC,OAAO,KAAK,KAAK;eACnB,OAAO,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/visit/clone.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Create a deep clone of the given SQL AST node and all children nodes.
+ * @param node The node to deeply clone.
+ * @returns The cloned node.
+ */
+export declare function deepClone<T>(node: T): T;
+//# sourceMappingURL=clone.d.ts.map

package/dist/src/visit/clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.d.ts","sourceRoot":"","sources":["../../../src/visit/clone.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAkBvC"}

package/dist/src/visit/clone.js

@@ -0,0 +1,52 @@
+import { isNode } from '../ast/node.js';
+import { recurse } from './recurse.js';
+/**
+ * Create a deep clone of the given SQL AST node and all children nodes.
+ * @param node The node to deeply clone.
+ * @returns The cloned node.
+ */
+export function deepClone(node) {
+    const clone = shallowClone(node);
+    if (isNode(node)) {
+        const props = recurse[node.type];
+        const n = props?.length ?? 0;
+        for (let i = 0; i < n; ++i) {
+            const key = props[i];
+            // @ts-expect-error allow assignment
+            const value = node[key];
+            // @ts-expect-error allow assignment
+            clone[key] = Array.isArray(value)
+                ? value.map(v => deepClone(v))
+                : deepClone(value);
+        }
+    }
+    return clone;
+}
+/**
+ * Create a shallow clone of the given SQL AST node.
+ * @param node The node to clone.
+ * @returns The cloned node.
+ */
+function shallowClone(node) {
+    /** @type {T} */
+    let clone;
+    if (!node || typeof node !== 'object') {
+        return node;
+    }
+    else if (isNode(node)) {
+        clone = node.clone();
+    }
+    else if (node instanceof Date) {
+        // @ts-expect-error node is known to be Date
+        return new Date(+node);
+    }
+    else if (Array.isArray(node)) {
+        // @ts-expect-error allow slice
+        return node.slice();
+    }
+    else {
+        return { ...node };
+    }
+    return clone;
+}
+//# sourceMappingURL=clone.js.map

package/dist/src/visit/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../../src/visit/clone.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAI,IAAO;IAClC,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACjB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;YAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACrB,oCAAoC;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YACxB,oCAAoC;YACpC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAC/B,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC9B,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAI,IAAO;IAC9B,gBAAgB;IAChB,IAAI,KAAK,CAAC;IAEV,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;SAAM,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;QAChC,4CAA4C;QAC5C,OAAO,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;SAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,+BAA+B;QAC/B,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/src/visit/recurse.d.ts

@@ -0,0 +1,2 @@
+export declare const recurse: Record<string, string[]>;
+//# sourceMappingURL=recurse.d.ts.map

package/dist/src/visit/recurse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurse.d.ts","sourceRoot":"","sources":["../../../src/visit/recurse.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAiC5C,CAAC"}

package/dist/src/visit/recurse.js

@@ -0,0 +1,36 @@
+import { AGGREGATE, BETWEEN_OPERATOR, BINARY_OPERATOR, CASE, CAST, COLLATE, COLUMN_PARAM, COLUMN_REF, DESCRIBE_QUERY, EXPRESSION, FRAGMENT, FROM_CLAUSE, FUNCTION, IN_OPERATOR, LOGICAL_OPERATOR, NOT_BETWEEN_OPERATOR, ORDER_BY, PARAM, SCALAR_SUBQUERY, SELECT_CLAUSE, SELECT_QUERY, SET_OPERATION, UNARY_OPERATOR, UNARY_POSTFIX_OPERATOR, WHEN, WINDOW, WINDOW_CLAUSE, WINDOW_DEF, WINDOW_EXTENT_EXPR, WINDOW_FRAME, WINDOW_FUNCTION, WITH_CLAUSE } from '../constants.js';
+export const recurse = {
+    [AGGREGATE]: ['args', 'order', 'filter'],
+    [BETWEEN_OPERATOR]: ['expr', 'extent'],
+    [BINARY_OPERATOR]: ['left', 'right'],
+    [CASE]: ['expr', '_when', '_else'],
+    [CAST]: ['expr'],
+    [COLLATE]: ['expr'],
+    [COLUMN_PARAM]: ['param', 'table'],
+    [COLUMN_REF]: ['table'],
+    [DESCRIBE_QUERY]: ['query'],
+    [EXPRESSION]: ['node'],
+    [FRAGMENT]: ['spans'],
+    [FROM_CLAUSE]: ['expr'],
+    [FUNCTION]: ['args'],
+    [IN_OPERATOR]: ['expr', 'values'],
+    [LOGICAL_OPERATOR]: ['clauses'],
+    [NOT_BETWEEN_OPERATOR]: ['expr', 'extent'],
+    [ORDER_BY]: ['expr'],
+    [PARAM]: ['value'],
+    [SCALAR_SUBQUERY]: ['subquery'],
+    [SELECT_CLAUSE]: ['expr'],
+    [SELECT_QUERY]: ['_with', '_select', '_from', '_where', '_sample', '_groupby', '_having', '_window', '_qualify', '_orderby'],
+    [SET_OPERATION]: ['queries', '_orderby'],
+    [UNARY_OPERATOR]: ['expr'],
+    [UNARY_POSTFIX_OPERATOR]: ['expr'],
+    [WHEN]: ['when', 'then'],
+    [WINDOW]: ['func', 'def'],
+    [WINDOW_CLAUSE]: ['def'],
+    [WINDOW_DEF]: ['partition', 'order', 'framedef'],
+    [WINDOW_EXTENT_EXPR]: ['expr'],
+    [WINDOW_FRAME]: ['extent'],
+    [WINDOW_FUNCTION]: ['args'],
+    [WITH_CLAUSE]: ['query']
+};
+//# sourceMappingURL=recurse.js.map

package/dist/src/visit/recurse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recurse.js","sourceRoot":"","sources":["../../../src/visit/recurse.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,YAAY,EACZ,UAAU,EACV,cAAc,EACd,UAAU,EACV,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,oBAAoB,EACpB,QAAQ,EACR,KAAK,EACL,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,IAAI,EACJ,MAAM,EACN,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,WAAW,EACZ,MAAM,iBAAiB,CAAC;AAEzB,MAAM,CAAC,MAAM,OAAO,GAA6B;IAC/C,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC;IACxC,CAAC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;IACtC,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;IACpC,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC;IAClC,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC;IAChB,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC;IACnB,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;IAClC,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,CAAC;IACvB,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,CAAC;IAC3B,CAAC,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC;IACtB,CAAC,QAAQ,CAAC,EAAE,CAAC,OAAO,CAAC;IACrB,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,CAAC;IACvB,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC;IACpB,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;IACjC,CAAC,gBAAgB,CAAC,EAAE,CAAC,SAAS,CAAC;IAC/B,CAAC,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1C,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC;IACpB,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC;IAClB,CAAC,eAAe,CAAC,EAAE,CAAC,UAAU,CAAC;IAC/B,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,CAAC;IACzB,CAAC,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,CAAC;IAC5H,CAAC,aAAa,CAAC,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;IACxC,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,CAAC;IAC1B,CAAC,sBAAsB,CAAC,EAAE,CAAC,MAAM,CAAC;IAClC,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;IACzB,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,CAAC;IACxB,CAAC,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,UAAU,CAAC;IAChD,CAAC,kBAAkB,CAAC,EAAE,CAAC,MAAM,CAAC;IAC9B,CAAC,YAAY,CAAC,EAAE,CAAC,QAAQ,CAAC;IAC1B,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,CAAC;IAC3B,CAAC,WAAW,CAAC,EAAE,CAAC,OAAO,CAAC;CACzB,CAAC"}

package/dist/src/visit/rewrite.d.ts

@@ -0,0 +1,9 @@
+import { type ExprNode } from '../ast/node.js';
+/**
+ * Rewrite a SQL expression, based on a map of nodes to replace.
+ * This method copies nodes as needed; it does not modify the input node.
+ * @param node The root AST node of the expression.
+ * @param map The rewrite map. When encountered, key nodes are replaced by value nodes.
+ */
+export declare function rewrite(node: ExprNode, map: Map<ExprNode, ExprNode>): ExprNode | undefined;
+//# sourceMappingURL=rewrite.d.ts.map

package/dist/src/visit/rewrite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite.d.ts","sourceRoot":"","sources":["../../../src/visit/rewrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAU,MAAM,gBAAgB,CAAC;AAGvD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,wBA2BnE"}

package/dist/src/visit/rewrite.js

@@ -0,0 +1,39 @@
+import { isNode } from '../ast/node.js';
+import { recurse } from './recurse.js';
+/**
+ * Rewrite a SQL expression, based on a map of nodes to replace.
+ * This method copies nodes as needed; it does not modify the input node.
+ * @param node The root AST node of the expression.
+ * @param map The rewrite map. When encountered, key nodes are replaced by value nodes.
+ */
+export function rewrite(node, map) {
+    if (map.has(node)) {
+        return map.get(node);
+    }
+    else if (isNode(node)) {
+        const props = recurse[node.type];
+        const n = props?.length ?? 0;
+        if (n > 0) {
+            node = node.clone();
+            for (let i = 0; i < n; ++i) {
+                const prop = props[i];
+                // @ts-expect-error lookup valid property
+                const child = node[prop];
+                if (Array.isArray(child)) {
+                    // @ts-expect-error rewrite known property
+                    const a = (node[prop] = child.slice());
+                    const m = child.length;
+                    for (let j = 0; j < m; ++j) {
+                        a[j] = rewrite(child[j], map);
+                    }
+                }
+                else if (child) {
+                    // @ts-expect-error rewrite known property
+                    node[prop] = rewrite(child, map);
+                }
+            }
+        }
+    }
+    return node;
+}
+//# sourceMappingURL=rewrite.js.map

package/dist/src/visit/rewrite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rewrite.js","sourceRoot":"","sources":["../../../src/visit/rewrite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,GAA4B;IAClE,IAAI,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAClB,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,GAAG,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACtB,yCAAyC;gBACzC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;gBACzB,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBACzB,0CAA0C;oBAC1C,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;oBACvC,MAAM,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;oBACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;wBAC3B,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;qBAAM,IAAI,KAAK,EAAE,CAAC;oBACjB,0CAA0C;oBAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/visit/visitors.d.ts

@@ -0,0 +1,32 @@
+import { type AggregateNode } from '../ast/aggregate.js';
+import type { ColumnRefNode } from '../ast/column-ref.js';
+import type { SQLNode } from '../ast/node.js';
+import type { ParamLike } from '../types.js';
+/**
+ * Indicate if the input AST contains an aggregate expression.
+ * The string content of verbatim nodes is analyzed to try to identify
+ * unparsed aggregate functions calls within SQL strings.
+ * @param root The root of the AST to search.
+ * @returns Return 0 if no aggregate functions are found.
+ *  Sets bit 1 if an AggregateFunction instance is found.
+ *  Sets bit 2 if an aggregate embedded in verbatim text is found.
+ */
+export declare function isAggregateExpression(root: SQLNode): number;
+/**
+ * Collect all aggregate function nodes.
+ * @param root The root of the AST to search.
+ */
+export declare function collectAggregates(root: SQLNode): AggregateNode[];
+/**
+ * Collect all unique column references.
+ * Multiple references to the same column are de-duplicated, even if
+ * they are not object-equal node instances.
+ * @param root The root of the AST to search.
+ */
+export declare function collectColumns(root: SQLNode): ColumnRefNode[];
+/**
+ * Collect all unique dynamic parameter instances.
+ * @param root The root of the AST to search.
+ */
+export declare function collectParams(root: SQLNode): ParamLike[];
+//# sourceMappingURL=visitors.d.ts.map

package/dist/src/visit/visitors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visitors.d.ts","sourceRoot":"","sources":["../../../src/visit/visitors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAkB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAkB7C;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,UA4BlD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,mBAQ9C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,mBAS3C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,eAQ1C"}