rawsql-ts 0.11.25-beta → 0.11.27-beta

package/dist/src/transformers/CTETableReferenceCollector.js

@@ -0,0 +1,358 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CTETableReferenceCollector = void 0;
+const Clause_1 = require("../models/Clause");
+const SelectQuery_1 = require("../models/SelectQuery");
+const ValueComponent_1 = require("../models/ValueComponent");
+/**
+ * A specialized table source collector designed for CTE dependency analysis.
+ *
+ * Unlike the general-purpose TableSourceCollector, this collector:
+ * - Always includes CTE references in results (treats CTEs as valid table sources)
+ * - Always performs deep traversal of subqueries, WHERE clauses, etc.
+ * - Is optimized for dependency analysis rather than database schema analysis
+ *
+ * This collector is specifically designed for use by CTEDependencyAnalyzer to track
+ * which tables/CTEs are referenced by queries at any nesting level.
+ */
+class CTETableReferenceCollector {
+    constructor() {
+        this.tableSources = [];
+        this.visitedNodes = new Set();
+        this.tableNameMap = new Map();
+        this.isRootVisit = true;
+        this.handlers = new Map();
+        // Setup handlers for query components
+        this.handlers.set(SelectQuery_1.SimpleSelectQuery.kind, (expr) => this.visitSimpleSelectQuery(expr));
+        this.handlers.set(SelectQuery_1.BinarySelectQuery.kind, (expr) => this.visitBinarySelectQuery(expr));
+        this.handlers.set(SelectQuery_1.ValuesQuery.kind, (expr) => this.visitValuesQuery(expr));
+        // Note: We intentionally do NOT handle WITH clause and CommonTable
+        // These are processed separately by CTEDependencyAnalyzer for CTE-to-CTE dependencies
+        // Handlers for FROM and JOIN components
+        this.handlers.set(Clause_1.FromClause.kind, (expr) => this.visitFromClause(expr));
+        this.handlers.set(Clause_1.JoinClause.kind, (expr) => this.visitJoinClause(expr));
+        this.handlers.set(Clause_1.JoinOnClause.kind, (expr) => this.visitJoinOnClause(expr));
+        this.handlers.set(Clause_1.JoinUsingClause.kind, (expr) => this.visitJoinUsingClause(expr));
+        // Source components
+        this.handlers.set(Clause_1.SourceExpression.kind, (expr) => this.visitSourceExpression(expr));
+        this.handlers.set(Clause_1.TableSource.kind, (expr) => this.visitTableSource(expr));
+        this.handlers.set(Clause_1.FunctionSource.kind, (expr) => this.visitFunctionSource(expr));
+        this.handlers.set(Clause_1.ParenSource.kind, (expr) => this.visitParenSource(expr));
+        this.handlers.set(Clause_1.SubQuerySource.kind, (expr) => this.visitSubQuerySource(expr));
+        this.handlers.set(ValueComponent_1.InlineQuery.kind, (expr) => this.visitInlineQuery(expr));
+        // Additional clause handlers for full scanning
+        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));
+        this.handlers.set(Clause_1.OffsetClause.kind, (expr) => this.visitOffsetClause(expr));
+        this.handlers.set(Clause_1.FetchClause.kind, (expr) => this.visitFetchClause(expr));
+        this.handlers.set(Clause_1.ForClause.kind, (expr) => this.visitForClause(expr));
+        this.handlers.set(Clause_1.OrderByItem.kind, (expr) => this.visitOrderByItem(expr));
+        this.handlers.set(Clause_1.SelectClause.kind, (expr) => this.visitSelectClause(expr));
+        this.handlers.set(Clause_1.SelectItem.kind, (expr) => this.visitSelectItem(expr));
+        // Value components that might contain table references
+        this.handlers.set(ValueComponent_1.ParenExpression.kind, (expr) => this.visitParenExpression(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.CaseExpression.kind, (expr) => this.visitCaseExpression(expr));
+        this.handlers.set(ValueComponent_1.CaseKeyValuePair.kind, (expr) => this.visitCaseKeyValuePair(expr));
+        this.handlers.set(ValueComponent_1.SwitchCaseArgument.kind, (expr) => this.visitSwitchCaseArgument(expr));
+        this.handlers.set(ValueComponent_1.BetweenExpression.kind, (expr) => this.visitBetweenExpression(expr));
+        this.handlers.set(ValueComponent_1.FunctionCall.kind, (expr) => this.visitFunctionCall(expr));
+        this.handlers.set(ValueComponent_1.ArrayExpression.kind, (expr) => this.visitArrayExpression(expr));
+        this.handlers.set(ValueComponent_1.ArrayQueryExpression.kind, (expr) => this.visitArrayQueryExpression(expr));
+        this.handlers.set(ValueComponent_1.TupleExpression.kind, (expr) => this.visitTupleExpression(expr));
+        this.handlers.set(ValueComponent_1.CastExpression.kind, (expr) => this.visitCastExpression(expr));
+        this.handlers.set(ValueComponent_1.ValueList.kind, (expr) => this.visitValueList(expr));
+        this.handlers.set(ValueComponent_1.StringSpecifierExpression.kind, (expr) => this.visitStringSpecifierExpression(expr));
+    }
+    /**
+     * Collects all table references from the given SQL component
+     * @param query The SQL component to analyze
+     * @returns Array of TableSource objects representing all table references
+     */
+    collect(query) {
+        this.visit(query);
+        return this.getTableSources();
+    }
+    /**
+     * Gets all collected table sources
+     */
+    getTableSources() {
+        return this.tableSources;
+    }
+    /**
+     * Reset the collection of table sources
+     */
+    reset() {
+        this.tableSources = [];
+        this.tableNameMap.clear();
+        this.visitedNodes.clear();
+    }
+    /**
+     * Gets a unique identifier for a table source
+     */
+    getTableIdentifier(source) {
+        // Use QualifiedName for identifier (dot-joined string)
+        if (source.qualifiedName.namespaces && source.qualifiedName.namespaces.length > 0) {
+            return source.qualifiedName.namespaces.map(ns => ns.name).join('.') + '.' + (source.qualifiedName.name instanceof ValueComponent_1.RawString ? source.qualifiedName.name.value : source.qualifiedName.name.name);
+        }
+        else {
+            return source.qualifiedName.name instanceof ValueComponent_1.RawString ? source.qualifiedName.name.value : source.qualifiedName.name.name;
+        }
+    }
+    /**
+     * Main entry point for the visitor pattern.
+     */
+    visit(arg) {
+        // If not a root visit, just visit the node and return
+        if (!this.isRootVisit) {
+            this.visitNode(arg);
+            return;
+        }
+        // If this is a root visit, we need to reset the state
+        this.reset();
+        this.isRootVisit = false;
+        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.
+     */
+    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;
+        }
+        // If no handler found, that's ok - we only care about specific components
+    }
+    visitSimpleSelectQuery(query) {
+        // Skip WITH clause processing - we only want to collect table references from the main query parts
+        // The WITH clause is handled separately by CTEDependencyAnalyzer for CTE-to-CTE dependencies
+        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.orderByClause) {
+            query.orderByClause.accept(this);
+        }
+        if (query.windowClause) {
+            for (const win of query.windowClause.windows) {
+                win.accept(this);
+            }
+        }
+        if (query.limitClause) {
+            query.limitClause.accept(this);
+        }
+        if (query.offsetClause) {
+            query.offsetClause.accept(this);
+        }
+        if (query.fetchClause) {
+            query.fetchClause.accept(this);
+        }
+        if (query.forClause) {
+            query.forClause.accept(this);
+        }
+        query.selectClause.accept(this);
+    }
+    visitBinarySelectQuery(query) {
+        // For UNION-like queries, visit both sides
+        query.left.accept(this);
+        query.right.accept(this);
+    }
+    visitValuesQuery(query) {
+        // VALUES queries might contain subqueries in tuple expressions
+        for (const tuple of query.tuples) {
+            tuple.accept(this);
+        }
+    }
+    visitFromClause(fromClause) {
+        // Check the main source in FROM clause
+        fromClause.source.accept(this);
+        // Check all JOIN clauses
+        if (fromClause.joins) {
+            for (const join of fromClause.joins) {
+                join.accept(this);
+            }
+        }
+    }
+    visitSourceExpression(source) {
+        // Process the actual data source, ignoring aliases
+        source.datasource.accept(this);
+    }
+    visitTableSource(source) {
+        // Get the table identifier for uniqueness check
+        const identifier = this.getTableIdentifier(source);
+        // Include all table sources (both real tables and CTEs)
+        if (!this.tableNameMap.has(identifier)) {
+            this.tableNameMap.set(identifier, true);
+            this.tableSources.push(source);
+        }
+    }
+    visitFunctionSource(source) {
+        // Function sources are not regular table sources, but may contain subqueries in their arguments
+        if (source.argument) {
+            this.visitValueComponent(source.argument);
+        }
+    }
+    visitValueComponent(value) {
+        value.accept(this);
+    }
+    visitParenSource(source) {
+        source.source.accept(this);
+    }
+    visitSubQuerySource(subQuery) {
+        // Always check subqueries in CTE analysis mode
+        subQuery.query.accept(this);
+    }
+    visitInlineQuery(inlineQuery) {
+        // Always visit inline queries
+        inlineQuery.selectQuery.accept(this);
+    }
+    visitJoinClause(joinClause) {
+        // Visit the source being joined
+        joinClause.source.accept(this);
+        // Visit the join condition
+        if (joinClause.condition) {
+            joinClause.condition.accept(this);
+        }
+    }
+    visitJoinOnClause(joinOn) {
+        joinOn.condition.accept(this);
+    }
+    visitJoinUsingClause(joinUsing) {
+        joinUsing.condition.accept(this);
+    }
+    // Additional visitor methods for comprehensive analysis
+    visitWhereClause(whereClause) {
+        whereClause.condition.accept(this);
+    }
+    visitGroupByClause(clause) {
+        for (const item of clause.grouping) {
+            item.accept(this);
+        }
+    }
+    visitHavingClause(clause) {
+        clause.condition.accept(this);
+    }
+    visitOrderByClause(clause) {
+        for (const item of clause.order) {
+            item.accept(this);
+        }
+    }
+    visitWindowFrameClause(clause) {
+        clause.expression.accept(this);
+    }
+    visitLimitClause(clause) {
+        clause.value.accept(this);
+    }
+    visitOffsetClause(clause) {
+        clause.value.accept(this);
+    }
+    visitFetchClause(clause) {
+        clause.expression.accept(this);
+    }
+    visitForClause(_clause) {
+        // FOR clause doesn't contain table sources
+    }
+    visitOrderByItem(item) {
+        item.value.accept(this);
+    }
+    visitSelectClause(clause) {
+        for (const item of clause.items) {
+            item.accept(this);
+        }
+    }
+    visitSelectItem(item) {
+        item.value.accept(this);
+    }
+    visitParenExpression(expr) {
+        expr.expression.accept(this);
+    }
+    visitBinaryExpression(expr) {
+        expr.left.accept(this);
+        expr.right.accept(this);
+    }
+    visitUnaryExpression(expr) {
+        expr.expression.accept(this);
+    }
+    visitCaseExpression(expr) {
+        if (expr.condition) {
+            expr.condition.accept(this);
+        }
+        expr.switchCase.accept(this);
+    }
+    visitSwitchCaseArgument(switchCase) {
+        for (const caseItem of switchCase.cases) {
+            caseItem.accept(this);
+        }
+        if (switchCase.elseValue) {
+            switchCase.elseValue.accept(this);
+        }
+    }
+    visitCaseKeyValuePair(pair) {
+        pair.key.accept(this);
+        pair.value.accept(this);
+    }
+    visitBetweenExpression(expr) {
+        expr.expression.accept(this);
+        expr.lower.accept(this);
+        expr.upper.accept(this);
+    }
+    visitFunctionCall(func) {
+        if (func.argument) {
+            func.argument.accept(this);
+        }
+        if (func.over) {
+            func.over.accept(this);
+        }
+    }
+    visitArrayExpression(expr) {
+        expr.expression.accept(this);
+    }
+    visitArrayQueryExpression(expr) {
+        expr.query.accept(this);
+    }
+    visitTupleExpression(expr) {
+        for (const value of expr.values) {
+            value.accept(this);
+        }
+    }
+    visitCastExpression(expr) {
+        expr.input.accept(this);
+        expr.castType.accept(this);
+    }
+    visitValueList(valueList) {
+        for (const value of valueList.values) {
+            value.accept(this);
+        }
+    }
+    visitStringSpecifierExpression(_expr) {
+        // StringSpecifierExpression doesn't contain table references
+    }
+}
+exports.CTETableReferenceCollector = CTETableReferenceCollector;
+//# sourceMappingURL=CTETableReferenceCollector.js.map

package/dist/src/transformers/CTETableReferenceCollector.js.map

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

package/dist/src/transformers/JoinAggregationDecomposer.d.ts

@@ -0,0 +1,188 @@
+import { SimpleSelectQuery } from "../models/SimpleSelectQuery";
+/**
+ * Options for JoinAggregationDecomposer
+ */
+export interface JoinDecomposerOptions {
+    /** Name for the detail CTE (default: "detail_data") */
+    detailCTEName?: string;
+}
+/**
+ * Result of decomposition analysis (safe, no exceptions)
+ */
+export interface DecompositionAnalysisResult {
+    /** Whether the query can be decomposed */
+    success: boolean;
+    /** The decomposed query if successful */
+    decomposedQuery?: SimpleSelectQuery;
+    /** Error message if failed */
+    error?: string;
+    /** Known limitations that may affect the result */
+    limitations?: string[];
+    /** Metadata about the decomposition process */
+    metadata: {
+        /** Number of JOINs found */
+        joinCount: number;
+        /** Number of aggregation functions found */
+        aggregationCount: number;
+        /** Columns included in detail CTE */
+        detailColumns: string[];
+        /** Whether HAVING clause exists */
+        hasHaving: boolean;
+        /** Whether ORDER BY clause exists */
+        hasOrderBy: boolean;
+        /** Whether window functions are present */
+        hasWindowFunctions: boolean;
+    };
+}
+/**
+ * Error thrown when query decomposition fails
+ */
+export declare class DecompositionError extends Error {
+    readonly originalQuery: SimpleSelectQuery;
+    readonly cause?: Error | undefined;
+    constructor(message: string, originalQuery: SimpleSelectQuery, cause?: Error | undefined);
+}
+/**
+ * Decomposes queries that combine table joins with aggregations into separate detail and aggregation queries using CTEs
+ *
+ * This transformer separates JOIN operations from aggregation operations to make queries easier to debug:
+ * - Detail query: Contains JOINs and column selection
+ * - Aggregation query: Contains GROUP BY and aggregation functions, referencing the CTE
+ *
+ * Provides two patterns following existing codebase conventions:
+ * - analyze(): Safe analysis (Result pattern like SelectQueryParser.analyze)
+ * - decompose(): Direct decomposition with exceptions (Exception pattern like SelectQueryParser.parse)
+ *
+ * @example
+ * ```typescript
+ * const decomposer = new JoinAggregationDecomposer();
+ *
+ * // Safe analysis (Result pattern)
+ * const analysis = decomposer.analyze(query);
+ * if (analysis.success) {
+ *   console.log('Can decompose with', analysis.metadata.joinCount, 'joins');
+ *   if (analysis.limitations) {
+ *     console.log('Known limitations:', analysis.limitations);
+ *   }
+ * } else {
+ *   console.log('Cannot decompose:', analysis.error);
+ * }
+ *
+ * // Direct decomposition (Exception pattern)
+ * try {
+ *   const decomposed = decomposer.decompose(query);
+ *   // Success: decomposed query ready to use
+ * } catch (error) {
+ *   if (error instanceof DecompositionError) {
+ *     console.log('Decomposition failed:', error.message);
+ *   }
+ * }
+ * ```
+ */
+export declare class JoinAggregationDecomposer {
+    private readonly options;
+    private readonly formatter;
+    constructor(options?: JoinDecomposerOptions);
+    /**
+     * Analyzes a query for decomposition without throwing errors (safe analysis)
+     * Follows the same pattern as SelectQueryParser.analyze()
+     *
+     * @param query The query to analyze
+     * @returns Analysis result with success status, error information, and metadata
+     */
+    analyze(query: SimpleSelectQuery): DecompositionAnalysisResult;
+    /**
+     * Decomposes a JOIN + aggregation query into separate detail and aggregation queries
+     * Follows the same pattern as SelectQueryParser.parse() - throws on error
+     *
+     * @param query The query to decompose
+     * @returns The decomposed query with CTE structure
+     * @throws DecompositionError if the query cannot be decomposed or formatted
+     */
+    decompose(query: SimpleSelectQuery): SimpleSelectQuery;
+    /**
+     * Gets validation error message without throwing (for analyze method)
+     */
+    private getValidationError;
+    /**
+     * Performs the actual decomposition
+     */
+    private performDecomposition;
+    /**
+     * Extracts metadata about the query
+     */
+    private extractMetadata;
+    /**
+     * Detects known limitations based on metadata
+     */
+    private detectLimitations;
+    /**
+     * Counts the number of JOINs in the query
+     */
+    private countJoins;
+    /**
+     * Counts aggregation functions in the query
+     */
+    private countAggregationFunctions;
+    /**
+     * Checks if query contains window functions
+     */
+    private hasWindowFunctions;
+    /**
+     * Checks if an expression contains aggregation functions
+     */
+    private containsAggregationFunction;
+    /**
+     * Checks if an expression contains window functions
+     */
+    private containsWindowFunction;
+    /**
+     * Gets function name from FunctionCall
+     */
+    private getFunctionName;
+    /**
+     * Extracts detail column names for metadata
+     */
+    private extractDetailColumnNames;
+    /**
+     * Extracts columns needed for the detail CTE
+     */
+    private extractDetailColumns;
+    /**
+     * Extracts column references from an expression
+     */
+    private extractColumnsFromExpression;
+    /**
+     * Gets a unique key for a column reference
+     */
+    private getColumnKey;
+    /**
+     * Builds the detail query (CTE content)
+     */
+    private buildDetailQuery;
+    /**
+     * Builds the aggregation query that references the CTE
+     */
+    private buildAggregationQuery;
+    /**
+     * Transforms an expression to reference CTE columns instead of original table columns
+     */
+    private transformExpressionForCTE;
+}
+/**
+ * Utility function to analyze a JOIN + aggregation query from SQL string (safe, no exceptions)
+ *
+ * @param sql The SQL string to parse and analyze
+ * @param options Decomposer options
+ * @returns Analysis result with success status, error information, and metadata
+ */
+export declare function analyzeJoinAggregation(sql: string, options?: JoinDecomposerOptions): DecompositionAnalysisResult;
+/**
+ * Utility function to decompose a JOIN + aggregation query from SQL string
+ *
+ * @param sql The SQL string to parse and decompose
+ * @param options Decomposer options
+ * @returns The decomposed query
+ * @throws DecompositionError if parsing or decomposition fails
+ */
+export declare function decomposeJoinAggregation(sql: string, options?: JoinDecomposerOptions): SimpleSelectQuery;