rawsql-ts 0.12.1 → 0.13.0

package/dist/src/parsers/OrderByClauseParser.js

@@ -0,0 +1,108 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrderByClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const Lexeme_1 = require("../models/Lexeme");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const ValueParser_1 = require("./ValueParser");
+class OrderByClauseParser {
+    // 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 ORDER BY 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 !== 'order by') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'ORDER BY' keyword but found "${lexemes[idx].value}". ORDER BY clauses must start with the ORDER BY keywords.`);
+        }
+        idx++;
+        const items = [];
+        const item = this.parseItem(lexemes, idx);
+        items.push(item.value);
+        idx = item.newIndex;
+        while (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Comma)) {
+            idx++;
+            const item = this.parseItem(lexemes, idx);
+            items.push(item.value);
+            idx = item.newIndex;
+        }
+        if (items.length === 0) {
+            throw new Error(`Syntax error at position ${index}: No ordering expressions found. The ORDER BY clause requires at least one expression to order by.`);
+        }
+        else {
+            const clause = new Clause_1.OrderByClause(items);
+            return { value: clause, newIndex: idx };
+        }
+    }
+    static parseItem(lexemes, index) {
+        let idx = index;
+        const parsedValue = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+        const value = parsedValue.value;
+        idx = parsedValue.newIndex;
+        if (idx >= lexemes.length) {
+            return { value: value, newIndex: idx };
+        }
+        // Capture comments from ASC/DESC tokens (both legacy comments and positioned comments)
+        let sortDirectionComments = null;
+        let sortDirection = null;
+        if (idx < lexemes.length) {
+            const token = lexemes[idx];
+            if (token.value === 'asc') {
+                sortDirection = Clause_1.SortDirection.Ascending;
+                idx++;
+            }
+            else if (token.value === 'desc') {
+                sortDirection = Clause_1.SortDirection.Descending;
+                idx++;
+            }
+            // Capture comments from the ASC/DESC token
+            if (sortDirection !== null) {
+                if (token.positionedComments && token.positionedComments.length > 0) {
+                    sortDirectionComments = [];
+                    for (const posComment of token.positionedComments) {
+                        if (posComment.comments && posComment.comments.length > 0) {
+                            sortDirectionComments.push(...posComment.comments);
+                        }
+                    }
+                }
+                if (token.comments && token.comments.length > 0) {
+                    if (!sortDirectionComments)
+                        sortDirectionComments = [];
+                    sortDirectionComments.push(...token.comments);
+                }
+            }
+        }
+        // nulls first, nulls last
+        const nullsSortDirection = idx >= lexemes.length
+            ? null
+            : lexemes[idx].value === 'nulls first'
+                ? (idx++, Clause_1.NullsSortDirection.First)
+                : lexemes[idx].value === 'nulls last'
+                    ? (idx++, Clause_1.NullsSortDirection.Last)
+                    : null;
+        // Apply sort direction comments to the value if captured
+        if (sortDirectionComments && sortDirectionComments.length > 0) {
+            if (value.comments) {
+                value.comments.push(...sortDirectionComments);
+            }
+            else {
+                value.comments = sortDirectionComments;
+            }
+        }
+        if (sortDirection === null && nullsSortDirection === null) {
+            return { value: value, newIndex: idx };
+        }
+        return { value: new Clause_1.OrderByItem(value, sortDirection, nullsSortDirection), newIndex: idx };
+    }
+}
+exports.OrderByClauseParser = OrderByClauseParser;
+//# sourceMappingURL=OrderByClauseParser.js.map

package/dist/src/parsers/OrderByClauseParser.js.map

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

package/dist/src/parsers/OverExpressionParser.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OverExpressionParser = void 0;
+const Lexeme_1 = require("../models/Lexeme");
+const ValueComponent_1 = require("../models/ValueComponent");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const WindowExpressionParser_1 = require("./WindowExpressionParser");
+class OverExpressionParser {
+    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 OVER expression is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        if (lexemes[idx].value !== 'over') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'OVER' keyword but found "${lexemes[idx].value}". OVER expressions must start with the OVER keyword.`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'OVER' keyword. Expected either a window name or an opening parenthesis '('.`);
+        }
+        if (lexemes[idx].type & Lexeme_1.TokenType.Identifier) {
+            // named window frame
+            const name = lexemes[idx].value;
+            idx++;
+            return { value: new ValueComponent_1.IdentifierString(name), newIndex: idx };
+        }
+        if (lexemes[idx].type & Lexeme_1.TokenType.OpenParen) {
+            // Delegate processing to WindowFrameExpressionParser
+            const result = WindowExpressionParser_1.WindowExpressionParser.parseFromLexeme(lexemes, idx);
+            return result;
+        }
+        throw new Error(`Syntax error at position ${idx}: Expected a window name or opening parenthesis '(' after OVER keyword, but found "${lexemes[idx].value}".`);
+    }
+}
+exports.OverExpressionParser = OverExpressionParser;
+//# sourceMappingURL=OverExpressionParser.js.map

package/dist/src/parsers/OverExpressionParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverExpressionParser.js","sourceRoot":"","sources":["../../../src/parsers/OverExpressionParser.ts"],"names":[],"mappings":";;;AAAA,6CAAqD;AACrD,6DAA4E;AAC5E,iDAA8C;AAC9C,qEAAkE;AAElE,MAAa,oBAAoB;IACtB,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,oEAAoE,CAAC,CAAC;QAC3L,CAAC;QAED,OAAO,MAAM,CAAC,KAAK,CAAC;IACxB,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAEhB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,wCAAwC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,uDAAuD,CAAC,CAAC;QACtK,CAAC;QACD,GAAG,EAAE,CAAC;QAEN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,0HAA0H,CAAC,CAAC;QAChJ,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,kBAAS,CAAC,UAAU,EAAE,CAAC;YAC3C,qBAAqB;YACrB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YAChC,GAAG,EAAE,CAAC;YACN,OAAO,EAAE,KAAK,EAAE,IAAI,iCAAgB,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAChE,CAAC;QAED,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,kBAAS,CAAC,SAAS,EAAE,CAAC;YAC1C,qDAAqD;YACrD,MAAM,MAAM,GAAG,+CAAsB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACpE,OAAO,MAAM,CAAC;QAClB,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,sFAAsF,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IACjK,CAAC;CACJ;AA3CD,oDA2CC"}

package/dist/src/parsers/ParameterDecorator.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParameterDecorator = void 0;
+/**
+ * This decorator formats parameter tokens according to DBMS-specific rules.
+ * It supports prefix/suffix, and parameter style (named, indexed, anonymous).
+ */
+class ParameterDecorator {
+    constructor(options) {
+        var _a, _b, _c;
+        this.prefix = (_a = options === null || options === void 0 ? void 0 : options.prefix) !== null && _a !== void 0 ? _a : ':';
+        this.suffix = (_b = options === null || options === void 0 ? void 0 : options.suffix) !== null && _b !== void 0 ? _b : '';
+        this.style = (_c = options === null || options === void 0 ? void 0 : options.style) !== null && _c !== void 0 ? _c : 'named';
+    }
+    /**
+     * Decorate a parameter token with DBMS-specific format.
+     * @param token The parameter token
+     * @param index The parameter index (for indexed/anonymous)
+     */
+    decorate(text, index) {
+        let paramText = '';
+        if (this.style === 'anonymous') {
+            // e.g. ?
+            paramText = this.prefix;
+        }
+        else if (this.style === 'indexed') {
+            // e.g. $1, ?1, :1
+            paramText = this.prefix + index;
+        }
+        else if (this.style === 'named') {
+            // e.g. :name, @name, ${name}
+            paramText = this.prefix + text + this.suffix;
+        }
+        // override 
+        text = paramText;
+        return text;
+    }
+}
+exports.ParameterDecorator = ParameterDecorator;
+//# sourceMappingURL=ParameterDecorator.js.map

package/dist/src/parsers/ParameterDecorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParameterDecorator.js","sourceRoot":"","sources":["../../../src/parsers/ParameterDecorator.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,kBAAkB;IAK3B,YAAY,OAAyF;;QACjG,IAAI,CAAC,MAAM,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,mCAAI,GAAG,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,MAAM,mCAAI,EAAE,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,MAAA,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,mCAAI,OAAO,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAAY,EAAE,KAAa;QAChC,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,IAAI,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC7B,SAAS;YACT,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAClC,kBAAkB;YAClB,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpC,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,EAAE,CAAC;YAChC,6BAA6B;YAC7B,SAAS,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACjD,CAAC;QAED,YAAY;QACZ,IAAI,GAAG,SAAS,CAAC;QACjB,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAjCD,gDAiCC"}

package/dist/src/parsers/ParameterExpressionParser.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParameterExpressionParser = void 0;
+const ValueComponent_1 = require("../models/ValueComponent");
+class ParameterExpressionParser {
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        let paramName = lexemes[idx].value;
+        // Normalize parameter: Remove the parameter symbol and extract the parameter name.
+        if (paramName.startsWith('${') && paramName.endsWith('}')) {
+            // ${name} → name
+            paramName = paramName.slice(2, -1);
+        }
+        else {
+            // :name → name
+            paramName = paramName.slice(1);
+        }
+        const value = new ValueComponent_1.ParameterExpression(paramName);
+        idx++;
+        return { value, newIndex: idx };
+    }
+}
+exports.ParameterExpressionParser = ParameterExpressionParser;
+//# sourceMappingURL=ParameterExpressionParser.js.map

package/dist/src/parsers/ParameterExpressionParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParameterExpressionParser.js","sourceRoot":"","sources":["../../../src/parsers/ParameterExpressionParser.ts"],"names":[],"mappings":";;;AACA,6DAA+E;AAE/E,MAAa,yBAAyB;IAC3B,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QAEnC,mFAAmF;QACnF,IAAI,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxD,iBAAiB;YACjB,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACJ,eAAe;YACf,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,oCAAmB,CAAC,SAAS,CAAC,CAAC;QACjD,GAAG,EAAE,CAAC;QACN,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IACpC,CAAC;CACJ;AAlBD,8DAkBC"}

package/dist/src/parsers/ParenExpressionParser.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParenExpressionParser = void 0;
+const Lexeme_1 = require("../models/Lexeme");
+const ValueComponent_1 = require("../models/ValueComponent");
+const SelectQueryParser_1 = require("./SelectQueryParser");
+const ValueParser_1 = require("./ValueParser");
+class ParenExpressionParser {
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        // Detect inline queries that start immediately after an opening parenthesis
+        if (idx + 1 < lexemes.length && lexemes[idx].type & Lexeme_1.TokenType.OpenParen && (lexemes[idx + 1].value === "select" ||
+            lexemes[idx + 1].value === "values" ||
+            lexemes[idx + 1].value === "with")) {
+            const openLexeme = lexemes[idx];
+            const openPositionedComments = openLexeme.positionedComments
+                ? openLexeme.positionedComments.map((comment) => ({
+                    position: comment.position,
+                    comments: [...comment.comments],
+                }))
+                : null;
+            const openLegacyComments = openLexeme.comments ? [...openLexeme.comments] : null;
+            idx += 1; // Skip the '(' token
+            const result = SelectQueryParser_1.SelectQueryParser.parseFromLexeme(lexemes, idx);
+            idx = result.newIndex;
+            // Validate that the inline query is properly closed
+            if (idx >= lexemes.length || lexemes[idx].type !== Lexeme_1.TokenType.CloseParen) {
+                throw new Error(`Expected ')' at index ${idx}, but found ${lexemes[idx].value}`);
+            }
+            // Capture trailing comments that belong to the inline query wrapper
+            const closingLexeme = lexemes[idx];
+            const closingLegacyComments = closingLexeme.comments;
+            const closingPositionedComments = closingLexeme.positionedComments;
+            idx++; // Skip the ')' token
+            const value = new ValueComponent_1.InlineQuery(result.value);
+            if (openPositionedComments && openPositionedComments.length > 0) {
+                // Convert inline query-leading comments from the opening parenthesis into 'before' positioned comments
+                const beforeComments = openPositionedComments
+                    .filter((comment) => comment.position === 'after' && comment.comments.length > 0)
+                    .map((comment) => ({
+                    position: 'before',
+                    comments: [...comment.comments],
+                }));
+                if (beforeComments.length > 0) {
+                    value.positionedComments = value.positionedComments
+                        ? [...beforeComments, ...value.positionedComments]
+                        : beforeComments;
+                }
+            }
+            else if (openLegacyComments && openLegacyComments.length > 0) {
+                // Legacy opening-parenthesis comments also become leading inline query comments
+                const beforeCommentBlock = { position: 'before', comments: [...openLegacyComments] };
+                value.positionedComments = value.positionedComments
+                    ? [beforeCommentBlock, ...value.positionedComments]
+                    : [beforeCommentBlock];
+            }
+            if (closingPositionedComments && closingPositionedComments.length > 0) {
+                // Only propagate comments that appear after the closing parenthesis (outside the inline query)
+                const afterComments = closingPositionedComments
+                    .filter((comment) => comment.position === 'after' && comment.comments.length > 0)
+                    .map((comment) => ({
+                    position: comment.position,
+                    comments: [...comment.comments],
+                }));
+                if (afterComments.length > 0) {
+                    value.positionedComments = value.positionedComments
+                        ? [...value.positionedComments, ...afterComments]
+                        : afterComments;
+                }
+            }
+            else if (closingLegacyComments && closingLegacyComments.length > 0) {
+                // Legacy comments are treated as trailing comments on the inline query
+                value.comments = closingLegacyComments;
+            }
+            return { value, newIndex: idx };
+        }
+        const result = ValueParser_1.ValueParser.parseArgument(Lexeme_1.TokenType.OpenParen, Lexeme_1.TokenType.CloseParen, lexemes, index);
+        idx = result.newIndex;
+        const value = new ValueComponent_1.ParenExpression(result.value);
+        // Preserve comments that trail immediately after the closing parenthesis (e.g. `(expr) -- note`).
+        const closingIndex = idx - 1;
+        if (closingIndex >= 0 && closingIndex < lexemes.length) {
+            const closingLexeme = lexemes[closingIndex];
+            if (closingLexeme.type & Lexeme_1.TokenType.CloseParen) {
+                if (closingLexeme.positionedComments && closingLexeme.positionedComments.length > 0) {
+                    const afterComments = closingLexeme.positionedComments
+                        .filter(comment => comment.position === 'after' && comment.comments.length > 0)
+                        .map(comment => ({
+                        position: comment.position,
+                        comments: [...comment.comments],
+                    }));
+                    if (afterComments.length > 0) {
+                        value.positionedComments = value.positionedComments
+                            ? [...value.positionedComments, ...afterComments]
+                            : afterComments;
+                    }
+                }
+                else if (closingLexeme.comments && closingLexeme.comments.length > 0) {
+                    value.comments = value.comments
+                        ? value.comments.concat(closingLexeme.comments)
+                        : [...closingLexeme.comments];
+                }
+            }
+        }
+        return { value, newIndex: idx };
+    }
+}
+exports.ParenExpressionParser = ParenExpressionParser;
+//# sourceMappingURL=ParenExpressionParser.js.map

package/dist/src/parsers/ParenExpressionParser.js.map

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

package/dist/src/parsers/ParseError.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParseError = void 0;
+const Lexeme_1 = require("../models/Lexeme");
+class ParseError extends Error {
+    constructor(message, index, context) {
+        super(message);
+        this.index = index;
+        this.context = context;
+        this.name = "ParseError";
+    }
+    static fromUnparsedLexemes(lexemes, index, messagePrefix) {
+        const start = Math.max(0, index - 2);
+        const end = Math.min(lexemes.length, index + 3);
+        const context = lexemes.slice(start, end).map((lexeme, idx) => {
+            const marker = idx + start === index ? '>' : ' ';
+            const typeName = Lexeme_1.TokenType[lexeme.type] || lexeme.type; // Convert type to name if possible
+            return `${marker} ${idx + start}:${lexeme.value} [${typeName}]`;
+        }).join('\n');
+        const message = `${messagePrefix} Unparsed lexeme remains at index ${index}: ${lexemes[index].value}\nContext:\n${context}`;
+        return new ParseError(message, index, context);
+    }
+}
+exports.ParseError = ParseError;
+//# sourceMappingURL=ParseError.js.map

package/dist/src/parsers/ParseError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParseError.js","sourceRoot":"","sources":["../../../src/parsers/ParseError.ts"],"names":[],"mappings":";;;AAAA,6CAAqD;AAErD,MAAa,UAAW,SAAQ,KAAK;IACjC,YAAY,OAAe,EAAS,KAAa,EAAS,OAAe;QACrE,KAAK,CAAC,OAAO,CAAC,CAAC;QADiB,UAAK,GAAL,KAAK,CAAQ;QAAS,YAAO,GAAP,OAAO,CAAQ;QAErE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC7B,CAAC;IAEM,MAAM,CAAC,mBAAmB,CAAC,OAAiB,EAAE,KAAa,EAAE,aAAqB;QACrF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;YAC1D,MAAM,MAAM,GAAG,GAAG,GAAG,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;YACjD,MAAM,QAAQ,GAAG,kBAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,mCAAmC;YAC3F,OAAO,GAAG,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,KAAK,KAAK,QAAQ,GAAG,CAAC;QACpE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,OAAO,GAAG,GAAG,aAAa,qCAAqC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,eAAe,OAAO,EAAE,CAAC;QAC5H,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;CACJ;AAlBD,gCAkBC"}

package/dist/src/parsers/PartitionByParser.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PartitionByParser = void 0;
+const Clause_1 = require("../models/Clause");
+const Lexeme_1 = require("../models/Lexeme");
+const ValueComponent_1 = require("../models/ValueComponent");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const ValueParser_1 = require("./ValueParser");
+class PartitionByParser {
+    // 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 PARTITION BY 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 !== 'partition by') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'PARTITION BY' keyword but found "${lexemes[idx].value}". PARTITION BY clauses must start with the PARTITION BY keywords.`);
+        }
+        idx++;
+        const items = [];
+        const item = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+        items.push(item.value);
+        idx = item.newIndex;
+        while (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Comma)) {
+            idx++;
+            const item = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+            items.push(item.value);
+            idx = item.newIndex;
+        }
+        if (items.length === 0) {
+            throw new Error(`Syntax error at position ${index}: No partition expressions found. The PARTITION BY clause requires at least one expression to partition by.`);
+        }
+        else if (items.length === 1) {
+            const clause = new Clause_1.PartitionByClause(items[0]);
+            return { value: clause, newIndex: idx };
+        }
+        else {
+            const clause = new Clause_1.PartitionByClause(new ValueComponent_1.ValueList(items));
+            return { value: clause, newIndex: idx };
+        }
+    }
+}
+exports.PartitionByParser = PartitionByParser;
+//# sourceMappingURL=PartitionByParser.js.map

package/dist/src/parsers/PartitionByParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PartitionByParser.js","sourceRoot":"","sources":["../../../src/parsers/PartitionByParser.ts"],"names":[],"mappings":";;;AAAA,6CAAqD;AACrD,6CAAqD;AACrD,6DAAqE;AACrE,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,wEAAwE,CAAC,CAAC;QAC/L,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;QAChB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,cAAc,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,gDAAgD,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,oEAAoE,CAAC,CAAC;QAC3L,CAAC;QACD,GAAG,EAAE,CAAC;QACN,MAAM,KAAK,GAAqB,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,yBAAW,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACvD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QACpB,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,kBAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,GAAG,EAAE,CAAC;YACN,MAAM,IAAI,GAAG,yBAAW,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxB,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,6GAA6G,CAAC,CAAC;QACpK,CAAC;aAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,IAAI,0BAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC5C,CAAC;aAAM,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,0BAAiB,CAAC,IAAI,0BAAS,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC5C,CAAC;IACL,CAAC;CACJ;AA5CD,8CA4CC"}

package/dist/src/parsers/ReturningClauseParser.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReturningClauseParser = void 0;
+// Provides parsing for RETURNING clauses in SQL (used in UPDATE, INSERT, DELETE, etc.)
+const Lexeme_1 = require("../models/Lexeme");
+const Clause_1 = require("../models/Clause");
+const LexemeCommentUtils_1 = require("./utils/LexemeCommentUtils");
+const SelectClauseParser_1 = require("./SelectClauseParser");
+class ReturningClauseParser {
+    /**
+     * Parse RETURNING clause from lexemes, starting at the given index.
+     * Returns a ReturningClause instance and the new index after parsing.
+     */
+    static parseFromLexeme(lexemes, index) {
+        var _a, _b, _c, _d, _e;
+        let idx = index;
+        if (((_a = lexemes[idx]) === null || _a === void 0 ? void 0 : _a.value) !== "returning") {
+            throw new Error(`Syntax error at position ${idx}: Expected 'RETURNING' but found '${(_b = lexemes[idx]) === null || _b === void 0 ? void 0 : _b.value}'.`);
+        }
+        const returningLexeme = lexemes[idx];
+        const returningComments = (0, LexemeCommentUtils_1.extractLexemeComments)(returningLexeme);
+        idx++;
+        const items = [];
+        // Parse first item
+        const firstItemResult = SelectClauseParser_1.SelectItemParser.parseItem(lexemes, idx);
+        items.push(firstItemResult.value);
+        idx = firstItemResult.newIndex;
+        // Parse subsequent items separated by commas
+        while (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Comma)) {
+            const commaLexeme = lexemes[idx];
+            // We might want to attach comma comments to the previous item or next item
+            // SelectItemParser handles its own leading comments, but comma trailing comments might need handling.
+            // For simplicity, we let SelectItemParser handle comments attached to the item start.
+            // If we want to preserve comma comments precisely, we might need more logic, 
+            // but SelectClauseParser doesn't seem to do anything special for comma comments other than skipping them.
+            // However, ReturningClauseParser had complex comment handling.
+            // Let's rely on SelectItemParser for now as it is robust for SELECT lists.
+            idx++; // skip comma
+            const itemResult = SelectClauseParser_1.SelectItemParser.parseItem(lexemes, idx);
+            items.push(itemResult.value);
+            idx = itemResult.newIndex;
+        }
+        if (items.length === 0) {
+            const position = (_e = (_d = (_c = lexemes[idx]) === null || _c === void 0 ? void 0 : _c.position) === null || _d === void 0 ? void 0 : _d.startPosition) !== null && _e !== void 0 ? _e : idx;
+            throw new Error(`[ReturningClauseParser] Expected a column or '*' after RETURNING at position ${position}.`);
+        }
+        const clause = new Clause_1.ReturningClause(items);
+        if (returningComments.before.length > 0) {
+            clause.addPositionedComments("before", returningComments.before);
+        }
+        // returningComments.after are usually attached to the first item by SelectItemParser if they are immediately before it?
+        // Actually extractLexemeComments(returningLexeme) gets comments attached to RETURNING token.
+        // If there are comments after RETURNING, they should be attached to the clause or the first item.
+        // In the original parser:
+        // let pendingBeforeForNext: string[] = [...returningComments.after];
+        // And then added to the first column.
+        if (returningComments.after.length > 0 && items.length > 0) {
+            items[0].addPositionedComments("before", returningComments.after);
+        }
+        return { value: clause, newIndex: idx };
+    }
+}
+exports.ReturningClauseParser = ReturningClauseParser;
+//# sourceMappingURL=ReturningClauseParser.js.map

package/dist/src/parsers/ReturningClauseParser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReturningClauseParser.js","sourceRoot":"","sources":["../../../src/parsers/ReturningClauseParser.ts"],"names":[],"mappings":";;;AAAA,uFAAuF;AACvF,6CAAqD;AACrD,6CAA+D;AAC/D,mEAAmE;AACnE,6DAAwD;AAExD,MAAa,qBAAqB;IAC9B;;;OAGG;IACI,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,CAAA,MAAA,OAAO,CAAC,GAAG,CAAC,0CAAE,KAAK,MAAK,WAAW,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,qCAAqC,MAAA,OAAO,CAAC,GAAG,CAAC,0CAAE,KAAK,IAAI,CAAC,CAAC;QACjH,CAAC;QAED,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,MAAM,iBAAiB,GAAG,IAAA,0CAAqB,EAAC,eAAe,CAAC,CAAC;QACjE,GAAG,EAAE,CAAC;QAEN,MAAM,KAAK,GAAiB,EAAE,CAAC;QAE/B,mBAAmB;QACnB,MAAM,eAAe,GAAG,qCAAgB,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAClC,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC;QAE/B,6CAA6C;QAC7C,OAAO,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,kBAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YACnE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,2EAA2E;YAC3E,sGAAsG;YACtG,sFAAsF;YACtF,8EAA8E;YAC9E,0GAA0G;YAC1G,+DAA+D;YAC/D,2EAA2E;YAE3E,GAAG,EAAE,CAAC,CAAC,aAAa;YACpB,MAAM,UAAU,GAAG,qCAAgB,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC5D,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC7B,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC;QAC9B,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrB,MAAM,QAAQ,GAAG,MAAA,MAAA,MAAA,OAAO,CAAC,GAAG,CAAC,0CAAE,QAAQ,0CAAE,aAAa,mCAAI,GAAG,CAAC;YAC9D,MAAM,IAAI,KAAK,CAAC,gFAAgF,QAAQ,GAAG,CAAC,CAAC;QACjH,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,wBAAe,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,iBAAiB,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,MAAM,CAAC,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACrE,CAAC;QACD,wHAAwH;QACxH,6FAA6F;QAC7F,kGAAkG;QAClG,0BAA0B;QAC1B,qEAAqE;QACrE,sCAAsC;QAEtC,IAAI,iBAAiB,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzD,KAAK,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC,QAAQ,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;QACtE,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC5C,CAAC;CACJ;AA7DD,sDA6DC"}