rawsql-ts 0.11.33-beta → 0.11.34-beta

package/dist/esm/src/utils/ScopeResolver.js

@@ -0,0 +1,268 @@
+import { SimpleSelectQuery, BinarySelectQuery } from '../models/SelectQuery';
+import { TableSource, SubQuerySource } from '../models/Clause';
+import { CTECollector } from '../transformers/CTECollector';
+import { TextPositionUtils } from './TextPositionUtils';
+/**
+ * Resolves scope information at cursor positions for SQL IntelliSense
+ *
+ * Provides comprehensive scope analysis including table availability, CTE resolution,
+ * and column visibility for intelligent code completion suggestions.
+ *
+ * @example
+ * ```typescript
+ * const sql = `
+ *   WITH users AS (SELECT id, name FROM accounts)
+ *   SELECT u.name FROM users u
+ *   LEFT JOIN orders o ON u.id = o.user_id
+ *   WHERE u.|
+ * `;
+ * const scope = ScopeResolver.resolveAt(sql, { line: 4, column: 12 });
+ *
+ * console.log(scope.availableTables); // [{ name: 'users', alias: 'u' }, { name: 'orders', alias: 'o' }]
+ * console.log(scope.availableCTEs); // [{ name: 'users', columns: ['id', 'name'] }]
+ * ```
+ */
+export class ScopeResolver {
+    /**
+     * Resolve scope information at the specified cursor position
+     *
+     * @param sql - SQL text to analyze
+     * @param cursorPosition - Character position of cursor (0-based)
+     * @returns Complete scope information
+     */
+    static resolve(sql, cursorPosition) {
+        // Simplified for suggestion-only focus - return basic scope information
+        // Complex SQL parsing removed to avoid issues with incomplete SQL syntax
+        return this.createEmptyScope();
+    }
+    /**
+     * Resolve scope information at line/column position
+     *
+     * @param sql - SQL text to analyze
+     * @param position - Line and column position (1-based)
+     * @returns Complete scope information
+     */
+    static resolveAt(sql, position) {
+        const charOffset = TextPositionUtils.lineColumnToCharOffset(sql, position);
+        if (charOffset === -1) {
+            return this.createEmptyScope();
+        }
+        return this.resolve(sql, charOffset);
+    }
+    /**
+     * Get available columns for a specific table or alias
+     *
+     * @param sql - SQL text containing the query
+     * @param cursorPosition - Cursor position for scope resolution
+     * @param tableOrAlias - Table name or alias to get columns for
+     * @returns Array of available columns for the specified table
+     */
+    static getColumnsForTable(sql, cursorPosition, tableOrAlias) {
+        const scope = this.resolve(sql, cursorPosition);
+        // Find matching table
+        const table = scope.availableTables.find(t => t.name === tableOrAlias || t.alias === tableOrAlias);
+        if (!table) {
+            return [];
+        }
+        // Return columns for this table
+        return scope.visibleColumns.filter(col => col.tableName === table.name ||
+            (table.alias && col.tableAlias === table.alias));
+    }
+    static analyzeScopeFromQuery(query) {
+        const scope = {
+            availableTables: [],
+            availableCTEs: [],
+            subqueryLevel: 0,
+            visibleColumns: [],
+            currentQuery: query,
+            parentQueries: []
+        };
+        if (query instanceof SimpleSelectQuery) {
+            // Collect CTEs
+            scope.availableCTEs = this.collectCTEs(query);
+            // Collect tables from FROM and JOINs
+            scope.availableTables = this.collectTablesFromQuery(query);
+            // Collect visible columns
+            scope.visibleColumns = this.collectVisibleColumns(scope.availableTables, scope.availableCTEs);
+        }
+        else if (query instanceof BinarySelectQuery) {
+            // For UNION queries, analyze both sides
+            const leftScope = this.analyzeScopeFromQuery(query.left);
+            const rightScope = this.analyzeScopeFromQuery(query.right);
+            // Merge scopes (tables from both sides available)
+            scope.availableTables = [...leftScope.availableTables, ...rightScope.availableTables];
+            scope.availableCTEs = [...leftScope.availableCTEs, ...rightScope.availableCTEs];
+            scope.visibleColumns = [...leftScope.visibleColumns, ...rightScope.visibleColumns];
+        }
+        return scope;
+    }
+    static collectCTEs(query) {
+        const ctes = [];
+        if (query.withClause) {
+            const cteCollector = new CTECollector();
+            const collectedCTEs = cteCollector.collect(query);
+            for (const cte of collectedCTEs) {
+                ctes.push({
+                    name: cte.getSourceAliasName(),
+                    query: cte.query,
+                    columns: this.extractCTEColumns(cte.query),
+                    materialized: cte.materialized || false
+                });
+            }
+        }
+        return ctes;
+    }
+    static collectTablesFromQuery(query) {
+        const tables = [];
+        // Collect from FROM clause
+        if (query.fromClause) {
+            const fromTables = this.extractTablesFromFromClause(query.fromClause);
+            tables.push(...fromTables);
+        }
+        return tables;
+    }
+    static extractTablesFromFromClause(fromClause) {
+        var _a, _b, _c, _d;
+        const tables = [];
+        // Extract main source table
+        if (fromClause.source.datasource instanceof TableSource) {
+            const table = {
+                name: this.extractTableName(fromClause.source.datasource.qualifiedName),
+                alias: (_a = fromClause.source.aliasExpression) === null || _a === void 0 ? void 0 : _a.table.name,
+                schema: this.extractSchemaName(fromClause.source.datasource.qualifiedName),
+                fullName: this.getQualifiedNameString(fromClause.source.datasource.qualifiedName),
+                sourceType: 'table'
+            };
+            tables.push(table);
+        }
+        else if (fromClause.source.datasource instanceof SubQuerySource) {
+            const table = {
+                name: ((_b = fromClause.source.aliasExpression) === null || _b === void 0 ? void 0 : _b.table.name) || 'subquery',
+                alias: (_c = fromClause.source.aliasExpression) === null || _c === void 0 ? void 0 : _c.table.name,
+                fullName: ((_d = fromClause.source.aliasExpression) === null || _d === void 0 ? void 0 : _d.table.name) || 'subquery',
+                sourceType: 'subquery',
+                originalQuery: fromClause.source.datasource.query
+            };
+            tables.push(table);
+        }
+        // Collect from JOINs
+        if (fromClause.joins) {
+            for (const join of fromClause.joins) {
+                const joinTables = this.extractTablesFromJoin(join);
+                tables.push(...joinTables);
+            }
+        }
+        return tables;
+    }
+    static extractTablesFromJoin(join) {
+        var _a, _b, _c, _d;
+        const tables = [];
+        if (join.source.datasource instanceof TableSource) {
+            const table = {
+                name: this.extractTableName(join.source.datasource.qualifiedName),
+                alias: (_a = join.source.aliasExpression) === null || _a === void 0 ? void 0 : _a.table.name,
+                schema: this.extractSchemaName(join.source.datasource.qualifiedName),
+                fullName: this.getQualifiedNameString(join.source.datasource.qualifiedName),
+                sourceType: 'table'
+            };
+            tables.push(table);
+        }
+        else if (join.source.datasource instanceof SubQuerySource) {
+            const table = {
+                name: ((_b = join.source.aliasExpression) === null || _b === void 0 ? void 0 : _b.table.name) || 'subquery',
+                alias: (_c = join.source.aliasExpression) === null || _c === void 0 ? void 0 : _c.table.name,
+                fullName: ((_d = join.source.aliasExpression) === null || _d === void 0 ? void 0 : _d.table.name) || 'subquery',
+                sourceType: 'subquery',
+                originalQuery: join.source.datasource.query
+            };
+            tables.push(table);
+        }
+        return tables;
+    }
+    static getQualifiedNameString(qualifiedName) {
+        // Use the existing method from QualifiedName to get the string representation
+        return qualifiedName.toString();
+    }
+    static extractTableName(qualifiedName) {
+        const fullName = this.getQualifiedNameString(qualifiedName);
+        const parts = fullName.split('.');
+        return parts[parts.length - 1]; // Last part is table name
+    }
+    static extractSchemaName(qualifiedName) {
+        const fullName = this.getQualifiedNameString(qualifiedName);
+        const parts = fullName.split('.');
+        return parts.length > 1 ? parts[parts.length - 2] : undefined;
+    }
+    static extractCTEColumns(query) {
+        // Try to extract column names from CTE SELECT clause
+        try {
+            if (query instanceof SimpleSelectQuery && query.selectClause) {
+                const columns = [];
+                for (const item of query.selectClause.items) {
+                    // Use alias if available, otherwise try to extract from expression
+                    if (item.identifier) {
+                        columns.push(item.identifier.name);
+                    }
+                    else {
+                        // Try to extract column name from expression
+                        const columnName = this.extractColumnNameFromExpression(item.value);
+                        if (columnName) {
+                            columns.push(columnName);
+                        }
+                    }
+                }
+                return columns;
+            }
+        }
+        catch (error) {
+            // If extraction fails, return undefined
+        }
+        return undefined;
+    }
+    static extractColumnNameFromExpression(expression) {
+        // Simple extraction - can be enhanced based on ValueComponent types
+        if (expression && typeof expression === 'object' && 'value' in expression) {
+            return expression.value;
+        }
+        return undefined;
+    }
+    static collectVisibleColumns(tables, ctes) {
+        const columns = [];
+        // Add columns from CTEs
+        for (const cte of ctes) {
+            if (cte.columns) {
+                for (const columnName of cte.columns) {
+                    columns.push({
+                        name: columnName,
+                        tableName: cte.name,
+                        fullReference: `${cte.name}.${columnName}`
+                    });
+                }
+            }
+        }
+        // For regular tables, we would need schema information to determine columns
+        // This is a placeholder - in practice, this would integrate with database metadata
+        for (const table of tables) {
+            if (table.sourceType === 'table') {
+                // Placeholder - would query database schema
+                columns.push({
+                    name: '*',
+                    tableName: table.name,
+                    tableAlias: table.alias,
+                    fullReference: `${table.alias || table.name}.*`
+                });
+            }
+        }
+        return columns;
+    }
+    static createEmptyScope() {
+        return {
+            availableTables: [],
+            availableCTEs: [],
+            subqueryLevel: 0,
+            visibleColumns: [],
+            parentQueries: []
+        };
+    }
+}
+//# sourceMappingURL=ScopeResolver.js.map

package/dist/esm/src/utils/ScopeResolver.js.map

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

package/dist/esm/src/utils/TextPositionUtils.d.ts

@@ -0,0 +1,62 @@
+import { LineColumn } from './LexemeCursor';
+/**
+ * Utility functions for text position conversion and manipulation
+ *
+ * Provides centralized functionality for converting between different
+ * position representations commonly used in text processing and SQL parsing.
+ */
+export declare class TextPositionUtils {
+    /**
+     * Convert line/column position to character offset
+     *
+     * @param text - Source text
+     * @param position - Line/column position (1-based)
+     * @returns Character offset (0-based) or -1 if invalid
+     *
+     * @example
+     * ```typescript
+     * const text = "SELECT id\nFROM users";
+     * const charOffset = TextPositionUtils.lineColumnToCharOffset(text, { line: 2, column: 1 });
+     * console.log(charOffset); // 10 (position of 'F' in 'FROM')
+     * ```
+     */
+    static lineColumnToCharOffset(text: string, position: LineColumn): number;
+    /**
+     * Convert character offset to line/column position
+     *
+     * @param text - Source text
+     * @param charOffset - Character offset (0-based)
+     * @returns Line/column position (1-based) or null if invalid
+     *
+     * @example
+     * ```typescript
+     * const text = "SELECT id\nFROM users";
+     * const position = TextPositionUtils.charOffsetToLineColumn(text, 10);
+     * console.log(position); // { line: 2, column: 1 }
+     * ```
+     */
+    static charOffsetToLineColumn(text: string, charOffset: number): LineColumn | null;
+    /**
+     * Check if a position is within text bounds
+     *
+     * @param text - Source text
+     * @param position - Line/column position (1-based)
+     * @returns True if position is valid
+     */
+    static isValidPosition(text: string, position: LineColumn): boolean;
+    /**
+     * Get the line at the specified line number
+     *
+     * @param text - Source text
+     * @param lineNumber - Line number (1-based)
+     * @returns Line content or null if invalid
+     */
+    static getLine(text: string, lineNumber: number): string | null;
+    /**
+     * Get the total number of lines in text
+     *
+     * @param text - Source text
+     * @returns Number of lines
+     */
+    static getLineCount(text: string): number;
+}

package/dist/esm/src/utils/TextPositionUtils.js

@@ -0,0 +1,124 @@
+/**
+ * Utility functions for text position conversion and manipulation
+ *
+ * Provides centralized functionality for converting between different
+ * position representations commonly used in text processing and SQL parsing.
+ */
+export class TextPositionUtils {
+    /**
+     * Convert line/column position to character offset
+     *
+     * @param text - Source text
+     * @param position - Line/column position (1-based)
+     * @returns Character offset (0-based) or -1 if invalid
+     *
+     * @example
+     * ```typescript
+     * const text = "SELECT id\nFROM users";
+     * const charOffset = TextPositionUtils.lineColumnToCharOffset(text, { line: 2, column: 1 });
+     * console.log(charOffset); // 10 (position of 'F' in 'FROM')
+     * ```
+     */
+    static lineColumnToCharOffset(text, position) {
+        if (position.line < 1 || position.column < 1) {
+            return -1;
+        }
+        const lines = text.split('\n');
+        if (position.line > lines.length) {
+            return -1;
+        }
+        const targetLine = lines[position.line - 1];
+        if (position.column > targetLine.length + 1) {
+            return -1;
+        }
+        let offset = 0;
+        for (let i = 0; i < position.line - 1; i++) {
+            offset += lines[i].length + 1; // +1 for newline
+        }
+        offset += position.column - 1;
+        return offset;
+    }
+    /**
+     * Convert character offset to line/column position
+     *
+     * @param text - Source text
+     * @param charOffset - Character offset (0-based)
+     * @returns Line/column position (1-based) or null if invalid
+     *
+     * @example
+     * ```typescript
+     * const text = "SELECT id\nFROM users";
+     * const position = TextPositionUtils.charOffsetToLineColumn(text, 10);
+     * console.log(position); // { line: 2, column: 1 }
+     * ```
+     */
+    static charOffsetToLineColumn(text, charOffset) {
+        if (charOffset < 0 || charOffset > text.length) {
+            return null;
+        }
+        const lines = text.split('\n');
+        let currentOffset = 0;
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const lineLength = lines[lineIndex].length;
+            if (charOffset < currentOffset + lineLength) {
+                return {
+                    line: lineIndex + 1,
+                    column: charOffset - currentOffset + 1
+                };
+            }
+            if (charOffset === currentOffset + lineLength && lineIndex < lines.length - 1) {
+                return {
+                    line: lineIndex + 2,
+                    column: 1
+                };
+            }
+            currentOffset += lineLength + 1; // +1 for newline
+        }
+        // Handle position at very end
+        if (charOffset === text.length) {
+            const lastLine = lines[lines.length - 1];
+            return {
+                line: lines.length,
+                column: lastLine.length + 1
+            };
+        }
+        return null;
+    }
+    /**
+     * Check if a position is within text bounds
+     *
+     * @param text - Source text
+     * @param position - Line/column position (1-based)
+     * @returns True if position is valid
+     */
+    static isValidPosition(text, position) {
+        return this.lineColumnToCharOffset(text, position) !== -1;
+    }
+    /**
+     * Get the line at the specified line number
+     *
+     * @param text - Source text
+     * @param lineNumber - Line number (1-based)
+     * @returns Line content or null if invalid
+     */
+    static getLine(text, lineNumber) {
+        if (lineNumber < 1) {
+            return null;
+        }
+        const lines = text.split('\n');
+        if (lineNumber > lines.length) {
+            return null;
+        }
+        return lines[lineNumber - 1];
+    }
+    /**
+     * Get the total number of lines in text
+     *
+     * @param text - Source text
+     * @returns Number of lines
+     */
+    static getLineCount(text) {
+        return text.split('\n').length;
+    }
+}
+//# sourceMappingURL=TextPositionUtils.js.map

package/dist/esm/src/utils/TextPositionUtils.js.map

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