rawsql-ts 0.11.32-beta → 0.11.34-beta

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

@@ -0,0 +1,336 @@
+import { SelectQueryParser } from '../parsers/SelectQueryParser';
+import { LexemeCursor } from './LexemeCursor';
+import { TextPositionUtils } from './TextPositionUtils';
+/**
+ * Position-aware SQL parser with error recovery for IntelliSense
+ *
+ * Extends the standard parser to handle incomplete SQL and provide context
+ * for IntelliSense scenarios where users are actively typing.
+ *
+ * @example
+ * ```typescript
+ * // Parse incomplete SQL with error recovery
+ * const sql = "SELECT user.name FROM users user WHERE user.";
+ * const result = PositionAwareParser.parseToPosition(sql, sql.length, {
+ *   errorRecovery: true,
+ *   insertMissingTokens: true
+ * });
+ *
+ * console.log(result.tokenBeforeCursor?.value); // "."
+ * console.log(result.success); // true (with recovery)
+ * ```
+ */
+export class PositionAwareParser {
+    /**
+     * Parse SQL text up to a specific position with error recovery
+     *
+     * @param sql - SQL text to parse
+     * @param cursorPosition - Character position to parse up to (0-based) or line/column
+     * @param options - Parsing options including error recovery
+     * @returns Parse result with position-specific information
+     */
+    static parseToPosition(sql, cursorPosition, options = {}) {
+        const charPosition = typeof cursorPosition === 'number'
+            ? cursorPosition
+            : TextPositionUtils.lineColumnToCharOffset(sql, cursorPosition);
+        if (charPosition === -1) {
+            return {
+                success: false,
+                error: 'Invalid cursor position',
+                stoppedAtCursor: false
+            };
+        }
+        try {
+            // First, try normal parsing
+            const normalResult = this.tryNormalParse(sql, charPosition, options);
+            if (normalResult.success) {
+                return normalResult;
+            }
+            // If normal parsing fails and error recovery is enabled, try recovery
+            if (options.errorRecovery) {
+                return this.tryErrorRecovery(sql, charPosition, options);
+            }
+            return normalResult;
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                stoppedAtCursor: false
+            };
+        }
+    }
+    /**
+     * Parse current query from multi-query text at cursor position
+     *
+     * @param sql - Complete SQL text (may contain multiple statements)
+     * @param cursorPosition - Cursor position
+     * @param options - Parsing options
+     * @returns Parse result for the current query only
+     */
+    static parseCurrentQuery(sql, cursorPosition, options = {}) {
+        const charPosition = typeof cursorPosition === 'number'
+            ? cursorPosition
+            : TextPositionUtils.lineColumnToCharOffset(sql, cursorPosition);
+        if (charPosition === -1) {
+            return {
+                success: false,
+                error: 'Invalid cursor position',
+                stoppedAtCursor: false
+            };
+        }
+        // Split SQL by semicolons and find the query containing the cursor
+        const queryBoundaries = this.findQueryBoundaries(sql);
+        const currentQuery = this.findQueryAtPosition(queryBoundaries, charPosition);
+        if (!currentQuery) {
+            return {
+                success: false,
+                error: 'No query found at cursor position',
+                stoppedAtCursor: false
+            };
+        }
+        // Parse just the current query
+        const relativePosition = charPosition - currentQuery.start;
+        const querySQL = sql.substring(currentQuery.start, currentQuery.end);
+        return this.parseToPosition(querySQL, relativePosition, options);
+    }
+    static tryNormalParse(sql, cursorPosition, options) {
+        // Check for invalid cursor position first
+        if (cursorPosition < 0 || cursorPosition > sql.length) {
+            return {
+                success: false,
+                error: 'Invalid cursor position',
+                stoppedAtCursor: false
+            };
+        }
+        // Check if SQL appears incomplete (ends with dot, comma, etc.)
+        const trimmedSql = sql.trim();
+        const incompletePatterns = ['.', ',', 'SELECT', 'FROM', 'WHERE', 'JOIN', 'ON', 'GROUP BY', 'ORDER BY'];
+        const appearsIncomplete = incompletePatterns.some(pattern => trimmedSql.toLowerCase().endsWith(pattern.toLowerCase()));
+        // Try to parse the complete SQL
+        const analysisResult = SelectQueryParser.analyze(sql);
+        // If parsing failed OR SQL appears incomplete, return failure to trigger error recovery
+        if (!analysisResult.success || appearsIncomplete) {
+            return Object.assign(Object.assign({}, analysisResult), { success: false });
+        }
+        // Get tokens and find cursor token
+        const allTokens = this.getAllTokens(sql);
+        const cursorToken = this.findTokenAtPosition(allTokens, cursorPosition);
+        const beforeCursor = this.findTokenBeforePosition(allTokens, cursorPosition);
+        return Object.assign(Object.assign({}, analysisResult), { parsedTokens: allTokens, tokenBeforeCursor: beforeCursor, stoppedAtCursor: cursorPosition < sql.length, recoveryAttempts: 0 // Normal parse, no recovery needed
+         });
+    }
+    static tryErrorRecovery(sql, cursorPosition, options) {
+        const maxAttempts = options.maxRecoveryAttempts || 5;
+        let attempts = 0;
+        // Error recovery strategies in order of preference
+        const strategies = [
+            () => this.recoverWithTokenInsertion(sql, cursorPosition, options),
+            () => this.recoverWithTruncation(sql, cursorPosition, options),
+            () => this.recoverWithCompletion(sql, cursorPosition, options),
+            () => this.recoverWithMinimalSQL(sql, cursorPosition, options)
+        ];
+        for (const strategy of strategies) {
+            if (attempts >= maxAttempts)
+                break;
+            attempts++;
+            try {
+                const result = strategy();
+                if (result.success) {
+                    result.recoveryAttempts = attempts;
+                    return result;
+                }
+            }
+            catch (error) {
+                continue; // Try next strategy
+            }
+        }
+        // All recovery attempts failed
+        return {
+            success: false,
+            error: 'All error recovery attempts failed',
+            recoveryAttempts: attempts,
+            stoppedAtCursor: false
+        };
+    }
+    static recoverWithTokenInsertion(sql, cursorPosition, options) {
+        if (!options.insertMissingTokens) {
+            throw new Error('Token insertion disabled');
+        }
+        // Common patterns to fix
+        const fixes = [
+            { pattern: /SELECT\s*$/i, replacement: 'SELECT 1 ' },
+            { pattern: /FROM\s*$/i, replacement: 'FROM dual ' },
+            { pattern: /WHERE\s*$/i, replacement: 'WHERE 1=1 ' },
+            { pattern: /JOIN\s*$/i, replacement: 'JOIN dual ON 1=1 ' },
+            { pattern: /ON\s*$/i, replacement: 'ON 1=1 ' },
+            { pattern: /GROUP\s+BY\s*$/i, replacement: 'GROUP BY 1 ' },
+            { pattern: /ORDER\s+BY\s*$/i, replacement: 'ORDER BY 1 ' }
+        ];
+        let fixedSQL = sql;
+        for (const fix of fixes) {
+            if (fix.pattern.test(sql)) {
+                fixedSQL = sql.replace(fix.pattern, fix.replacement);
+                break;
+            }
+        }
+        if (fixedSQL === sql) {
+            throw new Error('No applicable token insertion found');
+        }
+        const result = SelectQueryParser.analyze(fixedSQL);
+        const tokens = this.getAllTokens(sql); // Use original SQL for tokens
+        return Object.assign(Object.assign({}, result), { parsedTokens: tokens, tokenBeforeCursor: this.findTokenBeforePosition(tokens, cursorPosition), stoppedAtCursor: true, recoveryAttempts: 1 });
+    }
+    static recoverWithTruncation(sql, cursorPosition, options) {
+        // Try truncating at cursor position and adding minimal completion
+        const truncated = sql.substring(0, cursorPosition);
+        const completions = [
+            '', // Try as-is first
+            ' 1', // Add simple expression
+            ' FROM dual', // Add FROM clause
+            ' WHERE 1=1' // Add WHERE clause
+        ];
+        for (const completion of completions) {
+            try {
+                const testSQL = truncated + completion;
+                const result = SelectQueryParser.analyze(testSQL);
+                if (result.success) {
+                    const tokens = this.getAllTokens(sql);
+                    return Object.assign(Object.assign({}, result), { parsedTokens: tokens.filter(t => t.position && t.position.startPosition <= cursorPosition), tokenBeforeCursor: this.findTokenBeforePosition(tokens, cursorPosition), stoppedAtCursor: true, recoveryAttempts: 1 });
+                }
+            }
+            catch (error) {
+                continue;
+            }
+        }
+        throw new Error('Truncation recovery failed');
+    }
+    static recoverWithCompletion(sql, cursorPosition, options) {
+        // Try completing common incomplete patterns
+        const beforeCursor = sql.substring(0, cursorPosition);
+        const afterCursor = sql.substring(cursorPosition);
+        const completions = [
+            { pattern: /\.\s*$/, completion: 'id' }, // Complete column reference
+            { pattern: /\w+\s*$/, completion: '' }, // Complete identifier
+            { pattern: /,\s*$/, completion: '1' }, // Complete list item
+            { pattern: /\(\s*$/, completion: '1)' } // Complete parentheses
+        ];
+        for (const comp of completions) {
+            if (comp.pattern.test(beforeCursor)) {
+                const testSQL = beforeCursor + comp.completion + afterCursor;
+                try {
+                    const result = SelectQueryParser.analyze(testSQL);
+                    if (result.success) {
+                        const tokens = this.getAllTokens(sql);
+                        return Object.assign(Object.assign({}, result), { parsedTokens: tokens, tokenBeforeCursor: this.findTokenBeforePosition(tokens, cursorPosition), stoppedAtCursor: true, recoveryAttempts: 1 });
+                    }
+                }
+                catch (error) {
+                    continue;
+                }
+            }
+        }
+        throw new Error('Completion recovery failed');
+    }
+    static recoverWithMinimalSQL(sql, cursorPosition, options) {
+        // Generate minimal valid SQL that preserves structure up to cursor
+        const minimalSQL = 'SELECT 1 FROM dual WHERE 1=1';
+        try {
+            const result = SelectQueryParser.analyze(minimalSQL);
+            const tokens = this.getAllTokens(sql);
+            return {
+                success: true,
+                query: result.query,
+                parsedTokens: tokens.filter(t => t.position && t.position.startPosition <= cursorPosition),
+                tokenBeforeCursor: this.findTokenBeforePosition(tokens, cursorPosition),
+                stoppedAtCursor: true,
+                partialAST: result.query,
+                recoveryAttempts: 1
+            };
+        }
+        catch (error) {
+            throw new Error('Minimal SQL recovery failed');
+        }
+    }
+    static getAllTokens(sql) {
+        try {
+            // Use LexemeCursor which includes position information
+            return LexemeCursor.getAllLexemesWithPosition(sql);
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    static findTokenAtPosition(tokens, position) {
+        return tokens.find(token => token.position &&
+            position >= token.position.startPosition &&
+            position < token.position.endPosition);
+    }
+    static findTokenBeforePosition(tokens, position) {
+        // Find the last token that ends at or before the position
+        let beforeToken;
+        for (const token of tokens) {
+            if (token.position) {
+                if (token.position.endPosition <= position) {
+                    beforeToken = token;
+                }
+                else if (token.position.startPosition < position) {
+                    // Current position is within this token, so previous token is the one before
+                    break;
+                }
+                else {
+                    // We've passed the cursor position
+                    break;
+                }
+            }
+        }
+        return beforeToken;
+    }
+    static findQueryBoundaries(sql) {
+        const boundaries = [];
+        let currentStart = 0;
+        let inString = false;
+        let stringChar = '';
+        let inComment = false;
+        for (let i = 0; i < sql.length; i++) {
+            const char = sql[i];
+            const nextChar = i < sql.length - 1 ? sql[i + 1] : '';
+            // Handle string literals
+            if (!inComment && (char === "'" || char === '"')) {
+                if (!inString) {
+                    inString = true;
+                    stringChar = char;
+                }
+                else if (char === stringChar) {
+                    inString = false;
+                    stringChar = '';
+                }
+                continue;
+            }
+            // Handle comments
+            if (!inString && char === '-' && nextChar === '-') {
+                inComment = true;
+                i++; // Skip next char
+                continue;
+            }
+            if (inComment && char === '\n') {
+                inComment = false;
+                continue;
+            }
+            // Handle semicolons (query boundaries)
+            if (!inString && !inComment && char === ';') {
+                boundaries.push({ start: currentStart, end: i });
+                currentStart = i + 1;
+            }
+        }
+        // Add final query if no trailing semicolon
+        if (currentStart < sql.length) {
+            boundaries.push({ start: currentStart, end: sql.length });
+        }
+        return boundaries;
+    }
+    static findQueryAtPosition(boundaries, position) {
+        return boundaries.find(boundary => position >= boundary.start && position <= boundary.end);
+    }
+}
+//# sourceMappingURL=PositionAwareParser.js.map

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

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

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

@@ -0,0 +1,127 @@
+import { SelectQuery } from '../models/SelectQuery';
+/**
+ * Information about a table available in the current scope
+ */
+export interface AvailableTable {
+    /** Table name (unqualified) */
+    name: string;
+    /** Table alias (if any) */
+    alias?: string;
+    /** Schema name (if qualified) */
+    schema?: string;
+    /** Full qualified name */
+    fullName: string;
+    /** Source type: 'table', 'cte', 'subquery' */
+    sourceType: 'table' | 'cte' | 'subquery';
+    /** Original table reference for subqueries */
+    originalQuery?: SelectQuery;
+}
+/**
+ * Information about a CTE available in the current scope
+ */
+export interface AvailableCTE {
+    /** CTE name */
+    name: string;
+    /** Column names if determinable */
+    columns?: string[];
+    /** The CTE query definition */
+    query: SelectQuery;
+    /** Whether the CTE is materialized */
+    materialized?: boolean;
+}
+/**
+ * Information about columns available for a specific table
+ */
+export interface AvailableColumn {
+    /** Column name */
+    name: string;
+    /** Table name the column belongs to */
+    tableName: string;
+    /** Table alias (if any) */
+    tableAlias?: string;
+    /** Data type (if known) */
+    type?: string;
+    /** Whether column is nullable */
+    nullable?: boolean;
+    /** Full qualified column reference */
+    fullReference: string;
+}
+/**
+ * Complete scope information at a cursor position
+ */
+export interface ScopeInfo {
+    /** Tables available at the current position */
+    availableTables: AvailableTable[];
+    /** CTEs available at the current position */
+    availableCTEs: AvailableCTE[];
+    /** Nesting level (0 = root query) */
+    subqueryLevel: number;
+    /** Columns visible from all tables in scope */
+    visibleColumns: AvailableColumn[];
+    /** Current query being analyzed */
+    currentQuery?: SelectQuery;
+    /** Parent queries (for nested contexts) */
+    parentQueries: SelectQuery[];
+}
+/**
+ * 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 declare 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: string, cursorPosition: number): ScopeInfo;
+    /**
+     * 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: string, position: {
+        line: number;
+        column: number;
+    }): ScopeInfo;
+    /**
+     * 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: string, cursorPosition: number, tableOrAlias: string): AvailableColumn[];
+    private static analyzeScopeFromQuery;
+    private static collectCTEs;
+    private static collectTablesFromQuery;
+    private static extractTablesFromFromClause;
+    private static extractTablesFromJoin;
+    private static getQualifiedNameString;
+    private static extractTableName;
+    private static extractSchemaName;
+    private static extractCTEColumns;
+    private static extractColumnNameFromExpression;
+    private static collectVisibleColumns;
+    private static createEmptyScope;
+}