rawsql-ts 0.12.0 → 0.13.0

package/dist/parsers/HavingParser.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HavingClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const ValueParser_1 = require("./ValueParser");
+class HavingClauseParser {
+    // Parse SQL string to AST (was: parse)
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query); // Initialize tokenizer
+        const lexemes = tokenizer.readLexmes(); // Get tokens
+        // Parse
+        const result = this.parseFromLexeme(lexemes, 0);
+        // Error if there are remaining tokens
+        if (result.newIndex < lexemes.length) {
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The HAVING clause is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    // Parse from lexeme array (was: parse)
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        if (lexemes[idx].value !== 'having') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'HAVING' keyword but found "${lexemes[idx].value}". HAVING clauses must start with the HAVING keyword.`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'HAVING' keyword. The HAVING clause requires a condition expression.`);
+        }
+        const item = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+        const clause = new Clause_1.HavingClause(item.value);
+        return { value: clause, newIndex: item.newIndex };
+    }
+}
+exports.HavingClauseParser = HavingClauseParser;
+//# sourceMappingURL=HavingParser.js.map

package/dist/parsers/HavingParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HavingParser.js","sourceRoot":"","sources":["../../src/parsers/HavingParser.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAEhD,iDAA8C;AAC9C,+CAA4C;AAE5C,MAAa,kBAAkB;IAC3B,uCAAuC;IAChC,MAAM,CAAC,KAAK,CAAC,KAAa;QAC7B,MAAM,SAAS,GAAG,IAAI,2BAAY,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAuB;QAClE,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,aAAa;QAErD,QAAQ;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEhD,sCAAsC;QACtC,IAAI,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,iBAAiB,MAAM,CAAC,QAAQ,kEAAkE,CAAC,CAAC;QACzL,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,uCAAuC;IAChC,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAEhB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,0CAA0C,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,uDAAuD,CAAC,CAAC;QACxK,CAAC;QACD,GAAG,EAAE,CAAC;QAEN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kHAAkH,CAAC,CAAC;QACxI,CAAC;QAED,MAAM,IAAI,GAAG,yBAAW,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,qBAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE5C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IACtD,CAAC;CACJ;AAnCD,gDAmCC"}

package/dist/parsers/IdentifierDecorator.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentifierDecorator = void 0;
+class IdentifierDecorator {
+    constructor(identifierEscape) {
+        var _a, _b;
+        this.start = (_a = identifierEscape === null || identifierEscape === void 0 ? void 0 : identifierEscape.start) !== null && _a !== void 0 ? _a : '"';
+        this.end = (_b = identifierEscape === null || identifierEscape === void 0 ? void 0 : identifierEscape.end) !== null && _b !== void 0 ? _b : '"';
+    }
+    decorate(text) {
+        // override
+        text = this.start + text + this.end;
+        return text;
+    }
+}
+exports.IdentifierDecorator = IdentifierDecorator;
+//# sourceMappingURL=IdentifierDecorator.js.map

package/dist/parsers/IdentifierDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentifierDecorator.js","sourceRoot":"","sources":["../../src/parsers/IdentifierDecorator.ts"],"names":[],"mappings":";;;AAAA,MAAa,mBAAmB;IAI5B,YAAY,gBAAmD;;QAC3D,IAAI,CAAC,KAAK,GAAG,MAAA,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAE,KAAK,mCAAI,GAAG,CAAC;QAC5C,IAAI,CAAC,GAAG,GAAG,MAAA,gBAAgB,aAAhB,gBAAgB,uBAAhB,gBAAgB,CAAE,GAAG,mCAAI,GAAG,CAAC;IAC5C,CAAC;IAED,QAAQ,CAAC,IAAY;QACjB,WAAW;QACX,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAdD,kDAcC"}

package/dist/parsers/IdentifierParser.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentifierParser = void 0;
+const FullNameParser_1 = require("./FullNameParser");
+const ValueComponent_1 = require("../models/ValueComponent");
+class IdentifierParser {
+    static parseFromLexeme(lexemes, index) {
+        // Use FullNameParser to robustly parse qualified identifiers, including wildcards and escaped names.
+        const { namespaces, name, newIndex } = FullNameParser_1.FullNameParser.parseFromLexeme(lexemes, index);
+        const value = new ValueComponent_1.ColumnReference(namespaces, name);
+        return { value, newIndex };
+    }
+}
+exports.IdentifierParser = IdentifierParser;
+//# sourceMappingURL=IdentifierParser.js.map

package/dist/parsers/IdentifierParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IdentifierParser.js","sourceRoot":"","sources":["../../src/parsers/IdentifierParser.ts"],"names":[],"mappings":";;;AAAA,qDAAkD;AAElD,6DAA2E;AAE3E,MAAa,gBAAgB;IAClB,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,qGAAqG;QACrG,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,+BAAc,CAAC,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtF,MAAM,KAAK,GAAG,IAAI,gCAAe,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACpD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC/B,CAAC;CACJ;AAPD,4CAOC"}

package/dist/parsers/InsertQueryParser.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InsertQueryParser = void 0;
+// filepath: src/parsers/InsertQueryParser.ts
+// Provides parsing for INSERT queries, supporting optional columns and WITH/SELECT/VALUES structure.
+const InsertQuery_1 = require("../models/InsertQuery");
+const Lexeme_1 = require("../models/Lexeme");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const SelectQueryParser_1 = require("./SelectQueryParser");
+const Clause_1 = require("../models/Clause");
+const SelectQueryWithClauseHelper_1 = require("../utils/SelectQueryWithClauseHelper");
+const WithClauseParser_1 = require("./WithClauseParser");
+const SourceExpressionParser_1 = require("./SourceExpressionParser");
+const ValuesQueryParser_1 = require("./ValuesQueryParser");
+const ReturningClauseParser_1 = require("./ReturningClauseParser");
+const ValueComponent_1 = require("../models/ValueComponent");
+const LexemeCommentUtils_1 = require("./utils/LexemeCommentUtils");
+class InsertQueryParser {
+    /**
+     * Parse SQL string to InsertQuery AST.
+     * @param query SQL string
+     */
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query);
+        const lexemes = tokenizer.readLexemes();
+        const result = this.parseFromLexeme(lexemes, 0);
+        if (result.newIndex < lexemes.length) {
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The INSERT query is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    /**
+     * Parse from lexeme array (for internal use and tests)
+     */
+    static parseFromLexeme(lexemes, index) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        let idx = index;
+        let withClause = null;
+        if (((_a = lexemes[idx]) === null || _a === void 0 ? void 0 : _a.value) === "with") {
+            const result = WithClauseParser_1.WithClauseParser.parseFromLexeme(lexemes, idx);
+            withClause = result.value;
+            idx = result.newIndex;
+        }
+        if (!lexemes[idx] || lexemes[idx].value !== "insert into") {
+            const found = (_c = (_b = lexemes[idx]) === null || _b === void 0 ? void 0 : _b.value) !== null && _c !== void 0 ? _c : "end of input";
+            throw new Error(`Syntax error at position ${idx}: Expected 'INSERT INTO' but found '${found}'.`);
+        }
+        const insertKeywordLexeme = lexemes[idx];
+        const insertKeywordComments = (0, LexemeCommentUtils_1.extractLexemeComments)(insertKeywordLexeme);
+        idx++;
+        const sourceResult = SourceExpressionParser_1.SourceExpressionParser.parseTableSourceFromLexemes(lexemes, idx);
+        const targetSource = sourceResult.value;
+        const targetDatasource = targetSource.datasource;
+        idx = sourceResult.newIndex;
+        // Route inline comments immediately following INSERT INTO to the table reference.
+        if (insertKeywordComments.after.length > 0) {
+            targetDatasource.addPositionedComments("before", insertKeywordComments.after);
+        }
+        let columnIdentifiers = null;
+        let trailingInsertComments = [];
+        if (((_d = lexemes[idx]) === null || _d === void 0 ? void 0 : _d.type) === Lexeme_1.TokenType.OpenParen) {
+            const openParenLexeme = lexemes[idx];
+            const parenComments = (0, LexemeCommentUtils_1.extractLexemeComments)(openParenLexeme);
+            idx++;
+            if (parenComments.before.length > 0) {
+                // Comments before '(' belong after the table name.
+                targetDatasource.addPositionedComments("after", parenComments.before);
+            }
+            columnIdentifiers = [];
+            let pendingBeforeForNext = [...parenComments.after];
+            while (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Identifier)) {
+                const columnLexeme = lexemes[idx];
+                const columnComments = (0, LexemeCommentUtils_1.extractLexemeComments)(columnLexeme);
+                const column = new ValueComponent_1.IdentifierString(columnLexeme.value);
+                // Attach leading comments gathered from preceding tokens and the identifier itself.
+                const beforeComments = [];
+                if (pendingBeforeForNext.length > 0) {
+                    beforeComments.push(...pendingBeforeForNext);
+                }
+                if (columnComments.before.length > 0) {
+                    beforeComments.push(...columnComments.before);
+                }
+                if (beforeComments.length > 0) {
+                    column.addPositionedComments("before", beforeComments);
+                }
+                if (columnComments.after.length > 0) {
+                    column.addPositionedComments("after", columnComments.after);
+                }
+                columnIdentifiers.push(column);
+                pendingBeforeForNext = [];
+                idx++;
+                if (((_e = lexemes[idx]) === null || _e === void 0 ? void 0 : _e.type) === Lexeme_1.TokenType.Comma) {
+                    const commaComments = (0, LexemeCommentUtils_1.extractLexemeComments)(lexemes[idx]);
+                    pendingBeforeForNext = [...commaComments.after];
+                    idx++;
+                    continue;
+                }
+                break;
+            }
+            if (pendingBeforeForNext.length > 0 && columnIdentifiers.length > 0) {
+                columnIdentifiers[columnIdentifiers.length - 1].addPositionedComments("after", pendingBeforeForNext);
+                pendingBeforeForNext = [];
+            }
+            if (((_f = lexemes[idx]) === null || _f === void 0 ? void 0 : _f.type) !== Lexeme_1.TokenType.CloseParen) {
+                throw new Error(`Syntax error at position ${idx}: Expected ')' after column list.`);
+            }
+            const closeParenComments = (0, LexemeCommentUtils_1.extractLexemeComments)(lexemes[idx]);
+            idx++;
+            if (closeParenComments.before.length > 0 && columnIdentifiers.length > 0) {
+                columnIdentifiers[columnIdentifiers.length - 1].addPositionedComments("after", closeParenComments.before);
+            }
+            if (closeParenComments.after.length > 0) {
+                // Comments after ')' should trail the entire INSERT clause.
+                trailingInsertComments = closeParenComments.after;
+            }
+            if (columnIdentifiers.length === 0) {
+                columnIdentifiers = [];
+            }
+        }
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input while parsing INSERT statement. VALUES or SELECT clause expected.`);
+        }
+        const nextToken = lexemes[idx].value.toLowerCase();
+        let dataQuery;
+        if (nextToken === "values") {
+            const valuesResult = ValuesQueryParser_1.ValuesQueryParser.parseFromLexeme(lexemes, idx);
+            dataQuery = valuesResult.value;
+            idx = valuesResult.newIndex;
+        }
+        else {
+            const selectResult = SelectQueryParser_1.SelectQueryParser.parseFromLexeme(lexemes, idx);
+            dataQuery = selectResult.value;
+            idx = selectResult.newIndex;
+        }
+        let returningClause = null;
+        if (((_g = lexemes[idx]) === null || _g === void 0 ? void 0 : _g.value) === "returning") {
+            const returningResult = ReturningClauseParser_1.ReturningClauseParser.parseFromLexeme(lexemes, idx);
+            returningClause = returningResult.value;
+            idx = returningResult.newIndex;
+        }
+        const insertClause = new Clause_1.InsertClause(targetSource, columnIdentifiers !== null && columnIdentifiers !== void 0 ? columnIdentifiers : null);
+        if (insertKeywordComments.before.length > 0) {
+            insertClause.addPositionedComments("before", insertKeywordComments.before);
+        }
+        if (trailingInsertComments.length > 0) {
+            insertClause.addPositionedComments("after", trailingInsertComments);
+        }
+        if (withClause) {
+            SelectQueryWithClauseHelper_1.SelectQueryWithClauseHelper.setWithClause(dataQuery, withClause);
+        }
+        return {
+            value: new InsertQuery_1.InsertQuery({
+                insertClause,
+                selectQuery: dataQuery,
+                returning: returningClause
+            }),
+            newIndex: idx
+        };
+    }
+}
+exports.InsertQueryParser = InsertQueryParser;
+//# sourceMappingURL=InsertQueryParser.js.map

package/dist/parsers/InsertQueryParser.js.map

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

package/dist/parsers/JoinClauseParser.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JoinClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const Lexeme_1 = require("../models/Lexeme");
+const CommandTokenReader_1 = require("../tokenReaders/CommandTokenReader");
+const SourceExpressionParser_1 = require("./SourceExpressionParser");
+const JoinOnClauseParser_1 = require("./JoinOnClauseParser");
+const JoinUsingClauseParser_1 = require("./JoinUsingClauseParser");
+class JoinClauseParser {
+    static tryParse(lexemes, index) {
+        let idx = index;
+        const joins = [];
+        while (this.isJoinCommand(lexemes, idx)) {
+            const joinClause = this.parseJoinClause(lexemes, idx);
+            joins.push(joinClause.value);
+            idx = joinClause.newIndex;
+        }
+        if (joins.length > 0) {
+            return { value: joins, newIndex: idx };
+        }
+        return null;
+    }
+    static isJoinKeyword(value) {
+        // Although performance is not ideal,
+        // we use keyword token reader to centralize keyword management
+        const result = CommandTokenReader_1.joinkeywordParser.parse(value, 0);
+        if (result) {
+            return true;
+        }
+        return false;
+    }
+    static parseLateral(lexemes, index) {
+        let idx = index;
+        if (idx < lexemes.length && lexemes[idx].value === 'lateral') {
+            // Skip 'lateral' keyword
+            idx++;
+            return { value: true, newIndex: idx };
+        }
+        return { value: false, newIndex: idx };
+    }
+    static isJoinCommand(lexemes, index) {
+        if (index >= lexemes.length) {
+            return false;
+        }
+        if (lexemes[index].type & Lexeme_1.TokenType.Comma || this.isJoinKeyword(lexemes[index].value) === true) {
+            return true;
+        }
+        return false;
+    }
+    static parseJoinClause(lexemes, index) {
+        let idx = index;
+        // Extract JOIN keyword and comments
+        const { joinType, joinComments, newIndex: joinIndex } = this.parseJoinKeyword(lexemes, idx);
+        idx = joinIndex;
+        // Parse lateral join
+        const lateralResult = this.parseLateral(lexemes, idx);
+        const lateral = lateralResult.value;
+        idx = lateralResult.newIndex;
+        // Parse the source expression to join with
+        const sourceResult = SourceExpressionParser_1.SourceExpressionParser.parseFromLexeme(lexemes, idx);
+        idx = sourceResult.newIndex;
+        // Try to parse join condition (ON or USING)
+        const joinClause = this.parseJoinCondition(lexemes, idx, joinType, sourceResult.value, lateral, joinComments);
+        if (joinClause) {
+            return joinClause;
+        }
+        // Natural join (no condition)
+        const naturalJoinClause = new Clause_1.JoinClause(joinType, sourceResult.value, null, lateral);
+        this.applyJoinComments(naturalJoinClause, joinComments);
+        return { value: naturalJoinClause, newIndex: idx };
+    }
+    // Extract JOIN keyword and its comments
+    static parseJoinKeyword(lexemes, index) {
+        const joinType = lexemes[index].value === "," ? "cross join" : lexemes[index].value;
+        const joinComments = this.extractJoinKeywordComments(lexemes[index]);
+        return { joinType, joinComments, newIndex: index + 1 };
+    }
+    // Extract comments from JOIN keyword token
+    static extractJoinKeywordComments(token) {
+        return {
+            positioned: token.positionedComments && token.positionedComments.length > 0 ? token.positionedComments : null,
+            legacy: token.comments && token.comments.length > 0 ? token.comments : null
+        };
+    }
+    // Parse join condition (ON or USING)
+    static parseJoinCondition(lexemes, index, joinType, sourceValue, lateral, joinComments) {
+        if (index >= lexemes.length)
+            return null;
+        // Try JoinOnClauseParser
+        const onResult = JoinOnClauseParser_1.JoinOnClauseParser.tryParse(lexemes, index);
+        if (onResult) {
+            const joinClause = new Clause_1.JoinClause(joinType, sourceValue, onResult.value, lateral);
+            this.applyJoinComments(joinClause, joinComments);
+            return { value: joinClause, newIndex: onResult.newIndex };
+        }
+        // Try JoinUsingClauseParser
+        const usingResult = JoinUsingClauseParser_1.JoinUsingClauseParser.tryParse(lexemes, index);
+        if (usingResult) {
+            const joinClause = new Clause_1.JoinClause(joinType, sourceValue, usingResult.value, lateral);
+            this.applyJoinComments(joinClause, joinComments);
+            return { value: joinClause, newIndex: usingResult.newIndex };
+        }
+        return null;
+    }
+    // Apply comments to JoinClause directly (no collection then assignment)
+    static applyJoinComments(joinClause, joinComments) {
+        if (joinComments.positioned) {
+            joinClause.joinKeywordPositionedComments = joinComments.positioned;
+        }
+        else if (joinComments.legacy) {
+            joinClause.joinKeywordComments = joinComments.legacy;
+        }
+    }
+}
+exports.JoinClauseParser = JoinClauseParser;
+//# sourceMappingURL=JoinClauseParser.js.map

package/dist/parsers/JoinClauseParser.js.map

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

package/dist/parsers/JoinOnClauseParser.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JoinOnClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const ValueParser_1 = require("./ValueParser");
+class JoinOnClauseParser {
+    static tryParse(lexemes, index) {
+        let idx = index;
+        if (idx < lexemes.length && lexemes[idx].value === 'on') {
+            idx++; // Skip 'on' keyword
+            // Parse the condition expression
+            const condition = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+            idx = condition.newIndex;
+            const joinOn = new Clause_1.JoinOnClause(condition.value);
+            return { value: joinOn, newIndex: idx };
+        }
+        return null;
+    }
+}
+exports.JoinOnClauseParser = JoinOnClauseParser;
+//# sourceMappingURL=JoinOnClauseParser.js.map

package/dist/parsers/JoinOnClauseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoinOnClauseParser.js","sourceRoot":"","sources":["../../src/parsers/JoinOnClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAAgD;AAEhD,+CAA4C;AAE5C,MAAa,kBAAkB;IACpB,MAAM,CAAC,QAAQ,CAAC,OAAiB,EAAE,KAAa;QACnD,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;YACtD,GAAG,EAAE,CAAC,CAAC,oBAAoB;YAC3B,iCAAiC;YACjC,MAAM,SAAS,GAAG,yBAAW,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC5D,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC;YACzB,MAAM,MAAM,GAAG,IAAI,qBAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACjD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC5C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAbD,gDAaC"}

package/dist/parsers/JoinUsingClauseParser.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JoinUsingClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const Lexeme_1 = require("../models/Lexeme");
+const ValueParser_1 = require("./ValueParser");
+class JoinUsingClauseParser {
+    static tryParse(lexemes, index) {
+        let idx = index;
+        if (idx < lexemes.length && lexemes[idx].value === 'using') {
+            idx++; // Skip 'using' keyword
+            // Parse the columns in parentheses
+            const result = ValueParser_1.ValueParser.parseArgument(Lexeme_1.TokenType.OpenParen, Lexeme_1.TokenType.CloseParen, lexemes, idx);
+            const usingColumns = result.value;
+            idx = result.newIndex;
+            const joinUsing = new Clause_1.JoinUsingClause(usingColumns);
+            return { value: joinUsing, newIndex: idx };
+        }
+        return null;
+    }
+}
+exports.JoinUsingClauseParser = JoinUsingClauseParser;
+//# sourceMappingURL=JoinUsingClauseParser.js.map

package/dist/parsers/JoinUsingClauseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JoinUsingClauseParser.js","sourceRoot":"","sources":["../../src/parsers/JoinUsingClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAAmD;AACnD,6CAAqD;AACrD,+CAA4C;AAE5C,MAAa,qBAAqB;IACvB,MAAM,CAAC,QAAQ,CAAC,OAAiB,EAAE,KAAa;QACnD,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACzD,GAAG,EAAE,CAAC,CAAC,uBAAuB;YAC9B,mCAAmC;YACnC,MAAM,MAAM,GAAG,yBAAW,CAAC,aAAa,CAAC,kBAAS,CAAC,SAAS,EAAE,kBAAS,CAAC,UAAU,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC;YAClG,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC;YAClC,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC;YACtB,MAAM,SAAS,GAAG,IAAI,wBAAe,CAAC,YAAY,CAAC,CAAC;YACpD,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAdD,sDAcC"}

package/dist/parsers/KeywordParser.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeywordParser = exports.KeywordMatchResult = void 0;
+const stringUtils_1 = require("../utils/stringUtils");
+var KeywordMatchResult;
+(function (KeywordMatchResult) {
+    KeywordMatchResult[KeywordMatchResult["NotAKeyword"] = 0] = "NotAKeyword";
+    KeywordMatchResult[KeywordMatchResult["PartialOnly"] = 1] = "PartialOnly";
+    KeywordMatchResult[KeywordMatchResult["PartialOrFinal"] = 2] = "PartialOrFinal";
+    KeywordMatchResult[KeywordMatchResult["Final"] = 3] = "Final"; // "Complete match (no longer keywords after this)"
+})(KeywordMatchResult || (exports.KeywordMatchResult = KeywordMatchResult = {}));
+class KeywordParser {
+    constructor(trie) {
+        this.trie = trie;
+    }
+    isEndOfInput(input, position, shift = 0) {
+        return position + shift >= input.length;
+    }
+    canParse(input, position, shift = 0) {
+        return !this.isEndOfInput(input, position, shift);
+    }
+    parse(input, position) {
+        if (this.isEndOfInput(input, position)) {
+            return null;
+        }
+        // reset trie node
+        this.trie.reset();
+        const result = stringUtils_1.StringUtils.tryReadRegularIdentifier(input, position);
+        if (result === null) {
+            return null;
+        }
+        let matchResult = this.trie.pushLexeme(result.identifier.toLowerCase());
+        if (matchResult === KeywordMatchResult.NotAKeyword) {
+            return null;
+        }
+        if (matchResult === KeywordMatchResult.Final) {
+            return {
+                keyword: result.identifier,
+                newPosition: result.newPosition
+            };
+        }
+        // multi-word keyword
+        let lexeme = result.identifier;
+        const commentResult = stringUtils_1.StringUtils.readWhiteSpaceAndComment(input, result.newPosition);
+        position = commentResult.position;
+        const collectedComments = commentResult.lines ? [...commentResult.lines] : []; // Cache comments during multi-word parsing
+        // end of input
+        if (this.isEndOfInput(input, position)) {
+            if (matchResult === KeywordMatchResult.PartialOrFinal) {
+                // if the last match was partial or final, it means that the keyword is finished
+                return {
+                    keyword: lexeme,
+                    newPosition: position,
+                    comments: collectedComments.length > 0 ? collectedComments : undefined
+                };
+            }
+            else {
+                return null;
+            }
+        }
+        while (this.canParse(input, position)) {
+            const previousMatchResult = matchResult;
+            const result = stringUtils_1.StringUtils.tryReadRegularIdentifier(input, position);
+            if (result !== null) {
+                matchResult = this.trie.pushLexeme(result.identifier.toLowerCase());
+                if (matchResult === KeywordMatchResult.NotAKeyword) {
+                    if (previousMatchResult === KeywordMatchResult.PartialOrFinal) {
+                        break;
+                    }
+                    else {
+                        return null;
+                    }
+                }
+                lexeme += ' ' + result.identifier;
+                const nextCommentResult = stringUtils_1.StringUtils.readWhiteSpaceAndComment(input, result.newPosition);
+                position = nextCommentResult.position;
+                if (nextCommentResult.lines && nextCommentResult.lines.length > 0) {
+                    collectedComments.push(...nextCommentResult.lines); // Collect comments between multi-word tokens
+                }
+                if (matchResult === KeywordMatchResult.Final) {
+                    break;
+                }
+            }
+            else if (previousMatchResult === KeywordMatchResult.PartialOrFinal) {
+                break;
+            }
+            else {
+                return null;
+            }
+        }
+        return {
+            keyword: lexeme,
+            newPosition: position,
+            comments: collectedComments.length > 0 ? collectedComments : undefined
+        };
+    }
+}
+exports.KeywordParser = KeywordParser;
+//# sourceMappingURL=KeywordParser.js.map

package/dist/parsers/KeywordParser.js.map

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

package/dist/parsers/LimitClauseParser.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LimitClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const ValueParser_1 = require("./ValueParser");
+class LimitClauseParser {
+    // Parse SQL string to AST (was: parse)
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query); // Initialize tokenizer
+        const lexemes = tokenizer.readLexmes(); // Get tokens
+        // Parse
+        const result = this.parseFromLexeme(lexemes, 0);
+        // Error if there are remaining tokens
+        if (result.newIndex < lexemes.length) {
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The LIMIT clause is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    // Parse from lexeme array (was: parse)
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        if (lexemes[idx].value !== 'limit') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'LIMIT' keyword but found "${lexemes[idx].value}". LIMIT clauses must start with the LIMIT keyword.`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'LIMIT' keyword. The LIMIT clause requires a numeric expression.`);
+        }
+        // Parse LIMIT value
+        const limitItem = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+        idx = limitItem.newIndex;
+        const clause = new Clause_1.LimitClause(limitItem.value);
+        return { value: clause, newIndex: idx };
+    }
+}
+exports.LimitClauseParser = LimitClauseParser;
+//# sourceMappingURL=LimitClauseParser.js.map

package/dist/parsers/LimitClauseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LimitClauseParser.js","sourceRoot":"","sources":["../../src/parsers/LimitClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAA8D;AAE9D,iDAA8C;AAC9C,+CAA4C;AAE5C,MAAa,iBAAiB;IAC1B,uCAAuC;IAChC,MAAM,CAAC,KAAK,CAAC,KAAa;QAC7B,MAAM,SAAS,GAAG,IAAI,2BAAY,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAuB;QAClE,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC,CAAC,aAAa;QAErD,QAAQ;QACR,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEhD,sCAAsC;QACtC,IAAI,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,iBAAiB,MAAM,CAAC,QAAQ,iEAAiE,CAAC,CAAC;QACxL,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,uCAAuC;IAChC,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAEhB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,yCAAyC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,qDAAqD,CAAC,CAAC;QACrK,CAAC;QACD,GAAG,EAAE,CAAC;QAEN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,8GAA8G,CAAC,CAAC;QACpI,CAAC;QAED,oBAAoB;QACpB,MAAM,SAAS,GAAG,yBAAW,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC5D,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC;QAEzB,MAAM,MAAM,GAAG,IAAI,oBAAW,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEhD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC5C,CAAC;CACJ;AAtCD,8CAsCC"}

package/dist/parsers/LiteralParser.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiteralParser = void 0;
+const ValueComponent_1 = require("../models/ValueComponent");
+const LiteralTokenReader_1 = require("../tokenReaders/LiteralTokenReader");
+class LiteralParser {
+    static parseFromLexeme(lexemes, index) {
+        // Process literal value
+        let idx = index;
+        const valueText = lexemes[idx].value;
+        let parsedValue;
+        const lex = LiteralTokenReader_1.literalKeywordParser.parse(valueText.toLowerCase(), 0);
+        if (lex) {
+            const value = new ValueComponent_1.RawString(lex.keyword);
+            idx++;
+            return { value, newIndex: idx };
+        }
+        // Check if it is a number
+        if (/^[+-]?\d+(\.\d+)?([eE][+-]?\d+)?$/.test(valueText)) {
+            parsedValue = Number(valueText);
+            idx++;
+            const value = new ValueComponent_1.LiteralValue(parsedValue);
+            return { value, newIndex: idx };
+        }
+        // Otherwise, treat it as a string
+        else {
+            // Check if it's a dollar-quoted string or regular quoted string
+            if (/^\$[^$]*\$[\s\S]*\$[^$]*\$$/.test(valueText)) {
+                // For dollar-quoted strings, store the entire string including tags
+                parsedValue = valueText;
+            }
+            else if (valueText.startsWith("'") && valueText.endsWith("'")) {
+                // Remove single quotes if enclosed
+                parsedValue = valueText.slice(1, -1);
+            }
+            else {
+                parsedValue = valueText;
+            }
+            // Check if it was originally a quoted string literal
+            const isStringLiteral = valueText.startsWith("'") && valueText.endsWith("'");
+            idx++;
+            const value = new ValueComponent_1.LiteralValue(parsedValue, undefined, isStringLiteral);
+            return { value, newIndex: idx };
+        }
+    }
+}
+exports.LiteralParser = LiteralParser;
+//# sourceMappingURL=LiteralParser.js.map