rawsql-ts 0.1.0-beta.1 → 0.1.0-beta.11

package/dist/transformers/SelectableColumnCollector.js

@@ -0,0 +1,308 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelectableColumnCollector = void 0;
+// filepath: c:\Users\mssgm\Documents\GitHub\carbunqlex-ts\src\visitors\ColumnReferenceCollector.ts
+const Clause_1 = require("../models/Clause");
+const SelectQuery_1 = require("../models/SelectQuery");
+const ValueComponent_1 = require("../models/ValueComponent");
+const CTECollector_1 = require("./CTECollector");
+const Formatter_1 = require("./Formatter");
+const SelectValueCollector_1 = require("./SelectValueCollector");
+/**
+ * A visitor that collects all ColumnReference instances from a SQL query structure.
+ * This visitor scans through all clauses and collects all unique ColumnReference objects.
+ * It does not scan Common Table Expressions (CTEs) or subqueries.
+ *
+ * Important: Only collects column references to tables defined in the root FROM/JOIN clauses,
+ * as these are the only columns that can be directly referenced in the query.
+ */
+class SelectableColumnCollector {
+    constructor(tableColumnResolver) {
+        this.selectValues = [];
+        this.visitedNodes = new Set();
+        this.isRootVisit = true;
+        this.commonTables = [];
+        this.tableColumnResolver = tableColumnResolver;
+        this.selectValueCollector = new SelectValueCollector_1.SelectValueCollector();
+        this.commonTableCollector = new CTECollector_1.CTECollector();
+        this.commonTables = [];
+        this.formatter = new Formatter_1.Formatter();
+        this.handlers = new Map();
+        // Main entry point is the SimpleSelectQuery
+        this.handlers.set(SelectQuery_1.SimpleSelectQuery.kind, (expr) => this.visitSimpleSelectQuery(expr));
+        // Handlers for each clause type that might contain column references
+        this.handlers.set(Clause_1.SelectClause.kind, (expr) => this.visitSelectClause(expr));
+        this.handlers.set(Clause_1.FromClause.kind, (expr) => this.visitFromClause(expr));
+        this.handlers.set(Clause_1.WhereClause.kind, (expr) => this.visitWhereClause(expr));
+        this.handlers.set(Clause_1.GroupByClause.kind, (expr) => this.visitGroupByClause(expr));
+        this.handlers.set(Clause_1.HavingClause.kind, (expr) => this.visitHavingClause(expr));
+        this.handlers.set(Clause_1.OrderByClause.kind, (expr) => this.visitOrderByClause(expr));
+        this.handlers.set(Clause_1.WindowFrameClause.kind, (expr) => this.visitWindowFrameClause(expr));
+        this.handlers.set(Clause_1.LimitClause.kind, (expr) => this.visitLimitClause(expr));
+        // Add handlers for JOIN conditions
+        this.handlers.set(Clause_1.JoinOnClause.kind, (expr) => this.visitJoinOnClause(expr));
+        this.handlers.set(Clause_1.JoinUsingClause.kind, (expr) => this.visitJoinUsingClause(expr));
+        // For value components that might contain column references
+        this.handlers.set(ValueComponent_1.ColumnReference.kind, (expr) => this.visitColumnReference(expr));
+        this.handlers.set(ValueComponent_1.BinaryExpression.kind, (expr) => this.visitBinaryExpression(expr));
+        this.handlers.set(ValueComponent_1.UnaryExpression.kind, (expr) => this.visitUnaryExpression(expr));
+        this.handlers.set(ValueComponent_1.FunctionCall.kind, (expr) => this.visitFunctionCall(expr));
+        this.handlers.set(ValueComponent_1.ParenExpression.kind, (expr) => this.visitParenExpression(expr));
+        this.handlers.set(ValueComponent_1.CaseExpression.kind, (expr) => this.visitCaseExpression(expr));
+        this.handlers.set(ValueComponent_1.CastExpression.kind, (expr) => this.visitCastExpression(expr));
+        this.handlers.set(ValueComponent_1.BetweenExpression.kind, (expr) => this.visitBetweenExpression(expr));
+        this.handlers.set(ValueComponent_1.ArrayExpression.kind, (expr) => this.visitArrayExpression(expr));
+        this.handlers.set(ValueComponent_1.ValueList.kind, (expr) => this.visitValueList(expr));
+    }
+    getValues() {
+        return this.selectValues;
+    }
+    collect(arg) {
+        // Visit the component and return the collected select items
+        this.visit(arg);
+        const items = this.getValues();
+        this.reset(); // Reset after collection
+        return items;
+    }
+    /**
+     * Reset the collection of ColumnReferences
+     */
+    reset() {
+        this.selectValues = [];
+        this.visitedNodes.clear();
+        this.commonTables = [];
+    }
+    addSelectValueAsUnique(name, value) {
+        // Check if a select value with the same name already exists before adding
+        if (!this.selectValues.some(item => item.name === name)) {
+            this.selectValues.push({ name, value });
+        }
+    }
+    /**
+     * Main entry point for the visitor pattern.
+     * Implements the shallow visit pattern to distinguish between root and recursive visits.
+     */
+    visit(arg) {
+        // If not a root visit, just visit the node and return
+        if (!this.isRootVisit) {
+            this.visitNode(arg);
+            return;
+        }
+        if (!(arg instanceof SelectQuery_1.SimpleSelectQuery)) {
+            throw new Error("Root visit must be a SimpleSelectQuery");
+        }
+        // If this is a root visit, we need to reset the state
+        this.reset();
+        this.isRootVisit = false;
+        this.commonTables = this.commonTableCollector.collect(arg);
+        try {
+            this.visitNode(arg);
+        }
+        finally {
+            // Regardless of success or failure, reset the root visit flag
+            this.isRootVisit = true;
+        }
+    }
+    /**
+     * Internal visit method used for all nodes.
+     * This separates the visit flag management from the actual node visitation logic.
+     */
+    visitNode(arg) {
+        // Skip if we've already visited this node to prevent infinite recursion
+        if (this.visitedNodes.has(arg)) {
+            return;
+        }
+        // Mark as visited
+        this.visitedNodes.add(arg);
+        const handler = this.handlers.get(arg.getKind());
+        if (handler) {
+            handler(arg);
+            return;
+        }
+        // For any other component types, we don't need to do anything
+    }
+    /**
+      * Process a SimpleSelectQuery to collect ColumnReferences from all its clauses
+      */
+    visitSimpleSelectQuery(query) {
+        // Visit all clauses that might contain column references
+        if (query.selectClause) {
+            query.selectClause.accept(this);
+        }
+        if (query.fromClause) {
+            query.fromClause.accept(this);
+        }
+        if (query.whereClause) {
+            query.whereClause.accept(this);
+        }
+        if (query.groupByClause) {
+            query.groupByClause.accept(this);
+        }
+        if (query.havingClause) {
+            query.havingClause.accept(this);
+        }
+        if (query.windowFrameClause) {
+            query.windowFrameClause.accept(this);
+        }
+        if (query.orderByClause) {
+            query.orderByClause.accept(this);
+        }
+        if (query.rowLimitClause) {
+            query.rowLimitClause.accept(this);
+        }
+        if (query.forClause) {
+            query.forClause.accept(this);
+        }
+        // Explicitly NOT processing query.WithClause to avoid scanning CTEs
+    }
+    // Clause handlers
+    visitSelectClause(clause) {
+        if (clause.items) {
+            for (const item of clause.items) {
+                if (item instanceof Clause_1.SelectItem) {
+                    this.addSelectValueAsUnique(item.identifier.name, item.value);
+                }
+                else {
+                    item.accept(this);
+                }
+            }
+        }
+    }
+    visitFromClause(clause) {
+        // import source values
+        const collector = new SelectValueCollector_1.SelectValueCollector(this.tableColumnResolver, this.commonTables);
+        const sourceValues = collector.collect(clause);
+        for (const item of sourceValues) {
+            // Add the select value as unique to avoid duplicates
+            this.addSelectValueAsUnique(item.name, item.value);
+        }
+        if (clause.joins) {
+            for (const join of clause.joins) {
+                if (join.condition) {
+                    join.condition.accept(this);
+                }
+            }
+        }
+    }
+    visitWhereClause(clause) {
+        if (clause.condition) {
+            clause.condition.accept(this);
+        }
+    }
+    visitGroupByClause(clause) {
+        if (clause.grouping) {
+            for (const item of clause.grouping) {
+                item.accept(this);
+            }
+        }
+    }
+    visitHavingClause(clause) {
+        if (clause.condition) {
+            clause.condition.accept(this);
+        }
+    }
+    visitOrderByClause(clause) {
+        if (clause.order) {
+            for (const item of clause.order) {
+                item.accept(this);
+            }
+        }
+    }
+    visitWindowFrameClause(clause) {
+        if (clause.expression) {
+            clause.expression.accept(this);
+        }
+    }
+    visitLimitClause(clause) {
+        if (clause.limit) {
+            clause.limit.accept(this);
+        }
+        if (clause.offset) {
+            clause.offset.accept(this);
+        }
+    }
+    visitJoinOnClause(joinOnClause) {
+        // Visit the join condition
+        if (joinOnClause.condition) {
+            joinOnClause.condition.accept(this);
+        }
+    }
+    visitJoinUsingClause(joinUsingClause) {
+        // Visit the columns in the USING clause
+        if (joinUsingClause.condition) {
+            joinUsingClause.condition.accept(this);
+        }
+    }
+    // Value component handlers
+    visitColumnReference(columnRef) {
+        // Wildcards are ignored because they cannot be reused even if detected
+        if (columnRef.column.name !== "*") {
+            this.addSelectValueAsUnique(columnRef.column.name, columnRef);
+        }
+    }
+    visitBinaryExpression(expr) {
+        // Visit both sides of the expression
+        if (expr.left) {
+            expr.left.accept(this);
+        }
+        if (expr.right) {
+            expr.right.accept(this);
+        }
+    }
+    visitUnaryExpression(expr) {
+        if (expr.expression) {
+            expr.expression.accept(this);
+        }
+    }
+    visitFunctionCall(func) {
+        if (func.argument) {
+            func.argument.accept(this);
+        }
+        if (func.over) {
+            func.over.accept(this);
+        }
+    }
+    visitParenExpression(expr) {
+        if (expr.expression) {
+            expr.expression.accept(this);
+        }
+    }
+    visitCaseExpression(expr) {
+        if (expr.condition) {
+            expr.condition.accept(this);
+        }
+        if (expr.switchCase) {
+            expr.switchCase.accept(this);
+        }
+    }
+    visitCastExpression(expr) {
+        if (expr.input) {
+            expr.input.accept(this);
+        }
+    }
+    visitBetweenExpression(expr) {
+        if (expr.expression) {
+            expr.expression.accept(this);
+        }
+        if (expr.lower) {
+            expr.lower.accept(this);
+        }
+        if (expr.upper) {
+            expr.upper.accept(this);
+        }
+    }
+    visitArrayExpression(expr) {
+        if (expr.expression) {
+            expr.expression.accept(this);
+        }
+    }
+    visitValueList(expr) {
+        if (expr.values) {
+            for (const value of expr.values) {
+                value.accept(this);
+            }
+        }
+    }
+}
+exports.SelectableColumnCollector = SelectableColumnCollector;
+//# sourceMappingURL=SelectableColumnCollector.js.map

package/dist/transformers/SelectableColumnCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectableColumnCollector.js","sourceRoot":"","sources":["../../src/transformers/SelectableColumnCollector.ts"],"names":[],"mappings":"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"}

package/dist/transformers/TableColumnResolver.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Type definition for a function that resolves column names from a table name.
+ *
+ * This is used to provide table structure information (column names) for physical tables
+ * when expanding wildcard selectors (e.g., table.*) in SQL query analysis.
+ *
+ * @param tableName The name of the table to resolve columns for.
+ * @returns An array of column names (strings) for the specified table.
+ */
+export type TableColumnResolver = (tableName: string) => string[];

package/dist/transformers/TableColumnResolver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TableColumnResolver.js.map

package/dist/transformers/TableColumnResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableColumnResolver.js","sourceRoot":"","sources":["../../src/transformers/TableColumnResolver.ts"],"names":[],"mappings":""}

package/dist/transformers/TableSourceCollector.d.ts

@@ -0,0 +1,92 @@
+import { TableSource } from "../models/Clause";
+import { SqlComponent, SqlComponentVisitor } from "../models/SqlComponent";
+/**
+ * A visitor that collects all table source names from a SQL query structure.
+ *
+ * When selectableOnly is true (default behavior):
+ * - Includes only table sources from FROM and JOIN clauses
+ * - Excludes inline queries, subqueries, and CTEs
+ *
+ * When selectableOnly is false:
+ * - Scans all parts of the query including WITH clauses, subqueries, etc.
+ * - Collects all table sources from the entire query
+ * - Excludes tables that are managed by CTEs
+ *
+ * For UNION-like queries, it scans both the left and right parts.
+ */
+export declare class TableSourceCollector implements SqlComponentVisitor<void> {
+    private handlers;
+    private tableSources;
+    private visitedNodes;
+    private tableNameMap;
+    private selectableOnly;
+    private cteNames;
+    private isRootVisit;
+    constructor(selectableOnly?: boolean);
+    /**
+     * Gets all collected table sources
+     */
+    getTableSources(): TableSource[];
+    /**
+     * Reset the collection of table sources
+     */
+    private reset;
+    /**
+     * Gets a unique identifier for a table source
+     */
+    private getTableIdentifier;
+    collect(query: SqlComponent): TableSource[];
+    /**
+     * Main entry point for the visitor pattern.
+     * Implements the shallow visit pattern to distinguish between root and recursive visits.
+     */
+    visit(arg: SqlComponent): void;
+    /**
+     * Internal visit method used for all nodes.
+     * This separates the visit flag management from the actual node visitation logic.
+     */
+    private visitNode;
+    /**
+     * Collects all CTE names to exclude them from real table sources
+     */
+    private collectCTEs;
+    private visitSimpleSelectQuery;
+    private visitBinarySelectQuery;
+    private visitValuesQuery;
+    private visitWithClause;
+    private visitCommonTable;
+    private visitFromClause;
+    private visitSourceExpression;
+    private visitTableSource;
+    /**
+     * Checks if a table name is a CTE name
+     */
+    private isCTETable;
+    private visitParenSource;
+    private visitSubQuerySource;
+    private visitInlineQuery;
+    private visitJoinClause;
+    private visitJoinOnClause;
+    private visitJoinUsingClause;
+    private visitWhereClause;
+    private visitGroupByClause;
+    private visitHavingClause;
+    private visitOrderByClause;
+    private visitWindowFrameClause;
+    private visitLimitClause;
+    private visitForClause;
+    private visitOrderByItem;
+    private visitSelectClause;
+    private visitSelectItem;
+    private visitParenExpression;
+    private visitBinaryExpression;
+    private visitUnaryExpression;
+    private visitCaseExpression;
+    private visitSwitchCaseArgument;
+    private visitCaseKeyValuePair;
+    private visitBetweenExpression;
+    private visitFunctionCall;
+    private visitArrayExpression;
+    private visitTupleExpression;
+    private visitCastExpression;
+}