rawsql-ts 0.11.33-beta → 0.11.35-beta

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

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

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

@@ -0,0 +1,131 @@
+import { LineColumn } from './LexemeCursor';
+/**
+ * Information about a single query within multi-query text
+ */
+export interface QueryInfo {
+    /** SQL text of this query */
+    sql: string;
+    /** Start position in the original text (0-based character offset) */
+    start: number;
+    /** End position in the original text (0-based character offset) */
+    end: number;
+    /** Line number where query starts (1-based) */
+    startLine: number;
+    /** Line number where query ends (1-based) */
+    endLine: number;
+    /** Query index in the original text (0-based) */
+    index: number;
+    /** Whether this query is empty or contains only whitespace/comments */
+    isEmpty: boolean;
+}
+/**
+ * Collection of queries from multi-query text
+ */
+export interface QueryCollection {
+    /** All queries found in the text */
+    queries: QueryInfo[];
+    /** Original text that was split */
+    originalText: string;
+    /**
+     * Get the query that contains the specified cursor position
+     * @param cursorPosition - Cursor position (character offset or line/column)
+     */
+    getActive(cursorPosition: number | LineColumn): QueryInfo | undefined;
+    /**
+     * Get the query at the specified index
+     * @param index - Query index (0-based)
+     */
+    getQuery(index: number): QueryInfo | undefined;
+    /**
+     * Get all non-empty queries
+     */
+    getNonEmpty(): QueryInfo[];
+}
+/**
+ * Splits SQL text containing multiple queries separated by semicolons
+ *
+ * Provides sophisticated query boundary detection that properly handles:
+ * - String literals containing semicolons
+ * - Comments containing semicolons
+ * - Nested structures and complex SQL
+ * - Empty queries and whitespace handling
+ *
+ * @example
+ * ```typescript
+ * const multiSQL = `
+ *   -- First query
+ *   SELECT 'hello;world' FROM users;
+ *
+ *   // Second query with comment
+ *   SELECT id FROM orders WHERE status = 'active';
+ *
+ *   -- Empty query
+ *   ;
+ * `;
+ *
+ * const queries = MultiQuerySplitter.split(multiSQL);
+ * console.log(queries.queries.length); // 3 queries
+ *
+ * // Find query at cursor position
+ * const active = queries.getActive(150);
+ * console.log(active?.sql); // Query containing position 150
+ * ```
+ */
+export declare class MultiQuerySplitter {
+    /**
+     * Split multi-query SQL text into individual queries
+     *
+     * @param text - SQL text that may contain multiple queries separated by semicolons
+     * @returns Collection of individual queries with position information
+     */
+    static split(text: string): QueryCollection;
+    /**
+     * Get query boundaries from SQL text with proper semicolon handling
+     *
+     * @param text - SQL text to analyze
+     * @returns Array of boundary positions
+     */
+    /**
+     * Split text by semicolons while respecting quotes and comments
+     */
+    private static splitRespectingQuotesAndComments;
+    /**
+     * Check if character at position is a valid semicolon (not in quotes/comments)
+     */
+    private static isValidSemicolon;
+    /**
+     * Merge comment-only segments with previous executable segments
+     */
+    private static mergeTrailingCommentSegments;
+    /**
+     * Clean SQL comments and extract SQL statements
+     *
+     * @param sql - SQL query text
+     * @returns Cleaned SQL text or null if no SQL remains
+     */
+    private static cleanSqlComments;
+    private static isEmptyQuery;
+}
+/**
+ * Utility functions for working with query collections
+ */
+export declare class MultiQueryUtils {
+    /**
+     * Get context information for IntelliSense at a cursor position
+     *
+     * @param text - Multi-query SQL text
+     * @param cursorPosition - Cursor position
+     * @returns Active query and position within that query
+     */
+    static getContextAt(text: string, cursorPosition: number | LineColumn): {
+        query: QueryInfo;
+        relativePosition: number;
+    } | undefined;
+    /**
+     * Extract all non-empty queries from multi-query text
+     *
+     * @param text - Multi-query SQL text
+     * @returns Array of query SQL strings
+     */
+    static extractQueries(text: string): string[];
+}

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

@@ -0,0 +1,287 @@
+import { TextPositionUtils } from './TextPositionUtils';
+/**
+ * Splits SQL text containing multiple queries separated by semicolons
+ *
+ * Provides sophisticated query boundary detection that properly handles:
+ * - String literals containing semicolons
+ * - Comments containing semicolons
+ * - Nested structures and complex SQL
+ * - Empty queries and whitespace handling
+ *
+ * @example
+ * ```typescript
+ * const multiSQL = `
+ *   -- First query
+ *   SELECT 'hello;world' FROM users;
+ *
+ *   // Second query with comment
+ *   SELECT id FROM orders WHERE status = 'active';
+ *
+ *   -- Empty query
+ *   ;
+ * `;
+ *
+ * const queries = MultiQuerySplitter.split(multiSQL);
+ * console.log(queries.queries.length); // 3 queries
+ *
+ * // Find query at cursor position
+ * const active = queries.getActive(150);
+ * console.log(active?.sql); // Query containing position 150
+ * ```
+ */
+export class MultiQuerySplitter {
+    /**
+     * Split multi-query SQL text into individual queries
+     *
+     * @param text - SQL text that may contain multiple queries separated by semicolons
+     * @returns Collection of individual queries with position information
+     */
+    static split(text) {
+        const queries = [];
+        // Handle completely empty or whitespace-only text
+        if (!text || text.trim() === '') {
+            return {
+                queries: [],
+                originalText: text,
+                getActive: () => undefined,
+                getQuery: () => undefined,
+                getNonEmpty: () => []
+            };
+        }
+        const rawBoundaries = this.splitRespectingQuotesAndComments(text);
+        const boundaries = this.mergeTrailingCommentSegments(rawBoundaries, text);
+        let queryIndex = 0;
+        for (const boundary of boundaries) {
+            const rawSql = boundary.text.trim();
+            const isEmpty = this.isEmptyQuery(rawSql);
+            // Use raw SQL as-is - boundaries are already correctly split by valid semicolons
+            const sql = rawSql;
+            const startLineCol = TextPositionUtils.charOffsetToLineColumn(text, boundary.start);
+            const endLineCol = TextPositionUtils.charOffsetToLineColumn(text, boundary.end);
+            queries.push({
+                sql,
+                start: boundary.start,
+                end: boundary.end,
+                startLine: (startLineCol === null || startLineCol === void 0 ? void 0 : startLineCol.line) || 1,
+                endLine: (endLineCol === null || endLineCol === void 0 ? void 0 : endLineCol.line) || 1,
+                index: queryIndex++,
+                isEmpty
+            });
+        }
+        return {
+            queries,
+            originalText: text,
+            getActive: (cursorPosition) => {
+                const charPos = typeof cursorPosition === 'number'
+                    ? cursorPosition
+                    : TextPositionUtils.lineColumnToCharOffset(text, cursorPosition);
+                if (charPos === -1)
+                    return undefined;
+                return queries.find(query => charPos >= query.start && charPos <= query.end);
+            },
+            getQuery: (index) => {
+                return queries[index];
+            },
+            getNonEmpty: () => {
+                return queries.filter(q => !q.isEmpty);
+            }
+        };
+    }
+    /**
+     * Get query boundaries from SQL text with proper semicolon handling
+     *
+     * @param text - SQL text to analyze
+     * @returns Array of boundary positions
+     */
+    /**
+     * Split text by semicolons while respecting quotes and comments
+     */
+    static splitRespectingQuotesAndComments(text) {
+        const segments = [];
+        let currentStart = 0;
+        let i = 0;
+        while (i <= text.length) {
+            // Check if we're at a valid semicolon or end of text
+            const isValidBreakpoint = (i === text.length) || (i < text.length && this.isValidSemicolon(text, i));
+            if (isValidBreakpoint) {
+                const segmentText = text.substring(currentStart, i);
+                if (segmentText.length > 0 || i < text.length) {
+                    segments.push({
+                        text: segmentText,
+                        start: currentStart,
+                        end: i
+                    });
+                }
+                currentStart = i + 1;
+            }
+            i++;
+        }
+        return segments;
+    }
+    /**
+     * Check if character at position is a valid semicolon (not in quotes/comments)
+     */
+    static isValidSemicolon(text, pos) {
+        if (text[pos] !== ';')
+            return false;
+        // Check if this semicolon is inside quotes or comments by scanning from start
+        let inSingleQuote = false;
+        let inDoubleQuote = false;
+        let inLineComment = false;
+        let inBlockComment = false;
+        for (let i = 0; i < pos; i++) {
+            const char = text[i];
+            const nextChar = i + 1 < text.length ? text[i + 1] : '';
+            // Handle line comments
+            if (!inSingleQuote && !inDoubleQuote && !inBlockComment &&
+                char === '-' && nextChar === '-') {
+                inLineComment = true;
+                i++; // Skip next character
+                continue;
+            }
+            if (inLineComment && char === '\n') {
+                inLineComment = false;
+                continue;
+            }
+            // Handle block comments
+            if (!inSingleQuote && !inDoubleQuote && !inLineComment &&
+                char === '/' && nextChar === '*') {
+                inBlockComment = true;
+                i++; // Skip next character
+                continue;
+            }
+            if (inBlockComment && char === '*' && nextChar === '/') {
+                inBlockComment = false;
+                i++; // Skip next character
+                continue;
+            }
+            // Skip if in any comment
+            if (inLineComment || inBlockComment) {
+                continue;
+            }
+            // Handle quotes
+            if (char === "'" && !inDoubleQuote) {
+                if (inSingleQuote && nextChar === "'") {
+                    i++; // Skip escaped quote
+                }
+                else {
+                    inSingleQuote = !inSingleQuote;
+                }
+                continue;
+            }
+            if (char === '"' && !inSingleQuote) {
+                if (inDoubleQuote && nextChar === '"') {
+                    i++; // Skip escaped quote
+                }
+                else {
+                    inDoubleQuote = !inDoubleQuote;
+                }
+                continue;
+            }
+        }
+        // Return false if we're inside quotes or comments at this position
+        return !inSingleQuote && !inDoubleQuote && !inLineComment && !inBlockComment;
+    }
+    /**
+     * Merge comment-only segments with previous executable segments
+     */
+    static mergeTrailingCommentSegments(segments, fullText) {
+        const merged = [];
+        for (let i = 0; i < segments.length; i++) {
+            const segment = segments[i];
+            const segmentText = segment.text.trim();
+            // Check if this segment contains only comments/whitespace (no executable SQL)
+            const isCommentOnly = this.isEmptyQuery(segmentText);
+            if (isCommentOnly && merged.length > 0) {
+                // Only merge if this appears to be a trailing line comment (starts with --)
+                // and the previous segment contains executable SQL
+                const lastSegmentText = merged[merged.length - 1].text.trim();
+                const isTrailingLineComment = segmentText.startsWith('--');
+                const previousHasSQL = !this.isEmptyQuery(lastSegmentText);
+                if (isTrailingLineComment && previousHasSQL) {
+                    // Merge trailing line comment with previous SQL segment
+                    const lastSegment = merged[merged.length - 1];
+                    merged[merged.length - 1] = {
+                        text: fullText.substring(lastSegment.start, segment.end),
+                        start: lastSegment.start,
+                        end: segment.end
+                    };
+                }
+                else {
+                    // Keep as separate segment (empty query or standalone comment)
+                    merged.push(segment);
+                }
+            }
+            else {
+                // Add as new segment
+                merged.push(segment);
+            }
+        }
+        return merged;
+    }
+    /**
+     * Clean SQL comments and extract SQL statements
+     *
+     * @param sql - SQL query text
+     * @returns Cleaned SQL text or null if no SQL remains
+     */
+    static cleanSqlComments(sql) {
+        if (!sql)
+            return null;
+        // Remove comments and extract SQL
+        let cleaned = sql;
+        // Remove line comments - standard SQL behavior: -- comments out to end of line
+        cleaned = cleaned.split('\n').map(line => {
+            const commentStart = line.indexOf('--');
+            if (commentStart >= 0) {
+                return line.substring(0, commentStart);
+            }
+            return line;
+        }).join('\n');
+        // Remove block comments
+        cleaned = cleaned.replace(/\/\*[\s\S]*?\*\//g, '');
+        const result = cleaned.trim();
+        return result.length > 0 ? result : null;
+    }
+    static isEmptyQuery(sql) {
+        if (!sql)
+            return true;
+        return this.cleanSqlComments(sql) === null;
+    }
+}
+/**
+ * Utility functions for working with query collections
+ */
+export class MultiQueryUtils {
+    /**
+     * Get context information for IntelliSense at a cursor position
+     *
+     * @param text - Multi-query SQL text
+     * @param cursorPosition - Cursor position
+     * @returns Active query and position within that query
+     */
+    static getContextAt(text, cursorPosition) {
+        const queries = MultiQuerySplitter.split(text);
+        const activeQuery = queries.getActive(cursorPosition);
+        if (!activeQuery)
+            return undefined;
+        const charPos = typeof cursorPosition === 'number'
+            ? cursorPosition
+            : TextPositionUtils.lineColumnToCharOffset(text, cursorPosition);
+        if (charPos === -1)
+            return undefined;
+        const relativePosition = charPos - activeQuery.start;
+        return { query: activeQuery, relativePosition };
+    }
+    /**
+     * Extract all non-empty queries from multi-query text
+     *
+     * @param text - Multi-query SQL text
+     * @returns Array of query SQL strings
+     */
+    static extractQueries(text) {
+        const queries = MultiQuerySplitter.split(text);
+        return queries.getNonEmpty().map(q => q.sql);
+    }
+}
+//# sourceMappingURL=MultiQuerySplitter.js.map

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

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

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

@@ -0,0 +1,85 @@
+import { SelectQuery } from '../models/SelectQuery';
+import { ParseAnalysisResult } from '../parsers/SelectQueryParser';
+import { Lexeme } from '../models/Lexeme';
+import { LineColumn } from './LexemeCursor';
+/**
+ * Options for position-aware parsing
+ */
+export interface ParseToPositionOptions {
+    /** Enable error recovery to continue parsing after syntax errors */
+    errorRecovery?: boolean;
+    /** Insert missing tokens (e.g., missing FROM keywords) */
+    insertMissingTokens?: boolean;
+    /** Parse only up to the specified position */
+    parseToPosition?: {
+        line: number;
+        column: number;
+    } | number;
+    /** Maximum number of error recovery attempts */
+    maxRecoveryAttempts?: number;
+}
+/**
+ * Result of position-aware parsing
+ */
+export interface PositionParseResult extends ParseAnalysisResult {
+    /** Tokens that were parsed up to the cursor position */
+    parsedTokens?: Lexeme[];
+    /** Token immediately before the cursor position */
+    tokenBeforeCursor?: Lexeme;
+    /** Whether parsing stopped at the cursor position */
+    stoppedAtCursor?: boolean;
+    /** Number of error recovery attempts made */
+    recoveryAttempts?: number;
+    /** Partial AST even if parsing failed */
+    partialAST?: SelectQuery;
+}
+/**
+ * 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 declare 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: string, cursorPosition: number | LineColumn, options?: ParseToPositionOptions): PositionParseResult;
+    /**
+     * 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: string, cursorPosition: number | LineColumn, options?: ParseToPositionOptions): PositionParseResult;
+    private static tryNormalParse;
+    private static tryErrorRecovery;
+    private static recoverWithTokenInsertion;
+    private static recoverWithTruncation;
+    private static recoverWithCompletion;
+    private static recoverWithMinimalSQL;
+    private static getAllTokens;
+    private static findTokenAtPosition;
+    private static findTokenBeforePosition;
+    private static findQueryBoundaries;
+    private static findQueryAtPosition;
+}