rawsql-ts 0.12.1 → 0.13.0

package/dist/src/parsers/FetchClauseParser.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FetchExpressionParser = exports.FetchClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const ValueComponent_1 = require("../models/ValueComponent");
+const ValueParser_1 = require("./ValueParser");
+class FetchClauseParser {
+    /**
+     * Parses a FETCH clause from a lexeme array starting at the given index.
+     * Supports syntax like: FETCH [FIRST|NEXT] <count> ROWS ONLY
+     * @param lexemes The array of lexemes
+     * @param index The starting index
+     * @returns { value: FetchSpecification, newIndex: number }
+     */
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        if (lexemes[idx].value !== 'fetch') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'FETCH' keyword but found "${lexemes[idx].value}".`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'FETCH' keyword.`);
+        }
+        const fetchExprResult = FetchExpressionParser.parseFromLexeme(lexemes, idx);
+        const fetchExpr = fetchExprResult.value;
+        idx = fetchExprResult.newIndex;
+        return { value: new Clause_1.FetchClause(fetchExpr), newIndex: idx };
+    }
+}
+exports.FetchClauseParser = FetchClauseParser;
+// FetchExpressionParser: parses FETCH [FIRST|NEXT] <count> ROWS ONLY ...
+class FetchExpressionParser {
+    /**
+     * Parses a FETCH expression (not the whole clause, just the fetch part)
+     */
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        let type;
+        const typeToken = lexemes[idx].value;
+        if (typeToken === 'first') {
+            type = Clause_1.FetchType.First;
+        }
+        else if (typeToken === 'next') {
+            type = Clause_1.FetchType.Next;
+        }
+        else {
+            throw new Error(`Syntax error at position ${idx}: Expected 'FIRST' or 'NEXT' after 'FETCH' but found "${lexemes[idx].value}".`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'FETCH FIRST|NEXT'.`);
+        }
+        let count = null;
+        let unit = null;
+        // Omitted count notation
+        if (lexemes[idx].value === 'row only' || lexemes[idx].value === 'rows only') {
+            count = new ValueComponent_1.LiteralValue(1);
+            unit = Clause_1.FetchUnit.RowsOnly;
+            idx++;
+            return { value: new Clause_1.FetchExpression(type, count, unit), newIndex: idx };
+        }
+        // <count>
+        const countResult = ValueParser_1.ValueParser.parseFromLexeme(lexemes, idx);
+        count = countResult.value;
+        idx = countResult.newIndex;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'FETCH FIRST|NEXT <count>'.`);
+        }
+        // ROWS ONLY (or other unit)
+        if (lexemes[idx].value === 'rows only') {
+            unit = Clause_1.FetchUnit.RowsOnly;
+            idx++;
+        }
+        else if (lexemes[idx].value === 'percent') {
+            unit = Clause_1.FetchUnit.Percent;
+            idx++;
+        }
+        else if (lexemes[idx].value === 'percent with ties') {
+            unit = Clause_1.FetchUnit.PercentWithTies;
+            idx++;
+        }
+        if (!unit) {
+            throw new Error(`Syntax error: Expected 'ROWS ONLY', 'PERCENT', or 'PERCENT WITH TIES' after 'FETCH FIRST|NEXT <count>'.`);
+        }
+        return { value: new Clause_1.FetchExpression(type, count, unit), newIndex: idx };
+    }
+}
+exports.FetchExpressionParser = FetchExpressionParser;
+//# sourceMappingURL=FetchClauseParser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FetchClauseParser.js","sourceRoot":"","sources":["../../../src/parsers/FetchClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAAsF;AAEtF,6DAAwE;AACxE,+CAA4C;AAE5C,MAAa,iBAAiB;IAC1B;;;;;;OAMG;IACI,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,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,IAAI,CAAC,CAAC;QACpH,CAAC;QACD,GAAG,EAAE,CAAC;QACN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;QACpF,CAAC;QAED,MAAM,eAAe,GAAG,qBAAqB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC5E,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC;QACxC,GAAG,GAAG,eAAe,CAAC,QAAQ,CAAC;QAE/B,OAAO,EAAE,KAAK,EAAE,IAAI,oBAAW,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChE,CAAC;CACJ;AAxBD,8CAwBC;AAED,yEAAyE;AACzE,MAAa,qBAAqB;IAC9B;;OAEG;IACI,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAChB,IAAI,IAAe,CAAC;QACpB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QACrC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;YACxB,IAAI,GAAG,kBAAS,CAAC,KAAK,CAAC;QAC3B,CAAC;aAAM,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YAC9B,IAAI,GAAG,kBAAS,CAAC,IAAI,CAAC;QAC1B,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,yDAAyD,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;QACpI,CAAC;QACD,GAAG,EAAE,CAAC;QACN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,iEAAiE,CAAC,CAAC;QACvF,CAAC;QAED,IAAI,KAAK,GAA0B,IAAI,CAAC;QACxC,IAAI,IAAI,GAAqB,IAAI,CAAC;QAElC,yBAAyB;QACzB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YAC1E,KAAK,GAAG,IAAI,6BAAY,CAAC,CAAC,CAAC,CAAC;YAC5B,IAAI,GAAG,kBAAS,CAAC,QAAQ,CAAC;YAC1B,GAAG,EAAE,CAAC;YACN,OAAO,EAAE,KAAK,EAAE,IAAI,wBAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC5E,CAAC;QAED,UAAU;QACV,MAAM,WAAW,GAAG,yBAAW,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC9D,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC;QAC1B,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC;QAC3B,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;QAC/F,CAAC;QACD,4BAA4B;QAE5B,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,WAAW,EAAE,CAAC;YACrC,IAAI,GAAG,kBAAS,CAAC,QAAQ,CAAC;YAC1B,GAAG,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,IAAI,GAAG,kBAAS,CAAC,OAAO,CAAC;YACzB,GAAG,EAAE,CAAC;QACV,CAAC;aAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,KAAK,mBAAmB,EAAE,CAAC;YACpD,IAAI,GAAG,kBAAS,CAAC,eAAe,CAAC;YACjC,GAAG,EAAE,CAAC;QACV,CAAC;QACD,IAAI,CAAC,IAAI,EAAE,CAAC;YACR,MAAM,IAAI,KAAK,CAAC,yGAAyG,CAAC,CAAC;QAC/H,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,wBAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC5E,CAAC;CACJ;AAvDD,sDAuDC"}

package/dist/src/parsers/ForClauseParser.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ForClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+class ForClauseParser {
+    // Parse SQL string to AST (was: parse)
+    static parse(query) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(query);
+        const lexemes = tokenizer.readLexmes();
+        // 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 FOR clause is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    // Parse from lexeme array (was: parse)
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        // Check for FOR keyword
+        if (lexemes[idx].value.toLowerCase() !== 'for') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'FOR' keyword but found "${lexemes[idx].value}". FOR clauses must start with the FOR keyword.`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'FOR' keyword. The FOR clause requires a lock mode specification.`);
+        }
+        // Parse lock mode
+        const lockModeValue = lexemes[idx].value;
+        let lockMode;
+        switch (lockModeValue) {
+            case 'update':
+                lockMode = Clause_1.LockMode.Update;
+                idx++;
+                break;
+            case 'share':
+                lockMode = Clause_1.LockMode.Share;
+                idx++;
+                break;
+            case 'key share':
+                lockMode = Clause_1.LockMode.KeyShare;
+                idx++;
+                break;
+            case 'no key update':
+                lockMode = Clause_1.LockMode.NokeyUpdate;
+                idx++;
+                break;
+            default:
+                throw new Error(`Syntax error at position ${idx}: Invalid lock mode "${lockModeValue}". Valid lock modes are: UPDATE, SHARE, KEY SHARE, NO KEY UPDATE.`);
+        }
+        const clause = new Clause_1.ForClause(lockMode);
+        return { value: clause, newIndex: idx };
+    }
+}
+exports.ForClauseParser = ForClauseParser;
+//# sourceMappingURL=ForClauseParser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ForClauseParser.js","sourceRoot":"","sources":["../../../src/parsers/ForClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAAuD;AAEvD,iDAA8C;AAE9C,MAAa,eAAe;IACxB,uCAAuC;IAChC,MAAM,CAAC,KAAK,CAAC,KAAa;QAC7B,MAAM,SAAS,GAAG,IAAI,2BAAY,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,UAAU,EAAE,CAAC;QAEvC,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,+DAA+D,CAAC,CAAC;QACtL,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,wBAAwB;QACxB,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,uCAAuC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,iDAAiD,CAAC,CAAC;QAC/J,CAAC;QACD,GAAG,EAAE,CAAC;QAEN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,+GAA+G,CAAC,CAAC;QACrI,CAAC;QAED,kBAAkB;QAClB,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QACzC,IAAI,QAAkB,CAAC;QAEvB,QAAQ,aAAa,EAAE,CAAC;YACpB,KAAK,QAAQ;gBACT,QAAQ,GAAG,iBAAQ,CAAC,MAAM,CAAC;gBAC3B,GAAG,EAAE,CAAC;gBACN,MAAM;YACV,KAAK,OAAO;gBACR,QAAQ,GAAG,iBAAQ,CAAC,KAAK,CAAC;gBAC1B,GAAG,EAAE,CAAC;gBACN,MAAM;YACV,KAAK,WAAW;gBACZ,QAAQ,GAAG,iBAAQ,CAAC,QAAQ,CAAC;gBAC7B,GAAG,EAAE,CAAC;gBACN,MAAM;YACV,KAAK,eAAe;gBAChB,QAAQ,GAAG,iBAAQ,CAAC,WAAW,CAAC;gBAChC,GAAG,EAAE,CAAC;gBACN,MAAM;YACV;gBACI,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,wBAAwB,aAAa,mEAAmE,CAAC,CAAC;QACjK,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,kBAAS,CAAC,QAAQ,CAAC,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAC5C,CAAC;CACJ;AA3DD,0CA2DC"}

package/dist/src/parsers/FromClauseParser.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FromClauseParser = void 0;
+const Clause_1 = require("../models/Clause");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+const JoinClauseParser_1 = require("./JoinClauseParser");
+const SourceExpressionParser_1 = require("./SourceExpressionParser");
+const CommentUtils_1 = require("../utils/CommentUtils");
+class FromClauseParser {
+    // 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 FROM clause is complete but there are additional tokens.`);
+        }
+        return result.value;
+    }
+    // Parse from lexeme array (was: parse)
+    static parseFromLexeme(lexemes, index) {
+        let idx = index;
+        // Capture comments associated with the FROM clause
+        const fromTokenComments = CommentUtils_1.CommentUtils.collectClauseComments(lexemes, idx, 'from');
+        if (lexemes[idx].value !== 'from') {
+            throw new Error(`Syntax error at position ${idx}: Expected 'FROM' keyword but found "${lexemes[idx].value}". FROM clauses must start with the FROM keyword.`);
+        }
+        idx++;
+        if (idx >= lexemes.length) {
+            throw new Error(`Syntax error: Unexpected end of input after 'FROM' keyword. The FROM clause requires a table reference.`);
+        }
+        // Parse the main source expression
+        const sourceExpression = SourceExpressionParser_1.SourceExpressionParser.parseFromLexeme(lexemes, idx);
+        idx = sourceExpression.newIndex;
+        const join = JoinClauseParser_1.JoinClauseParser.tryParse(lexemes, idx);
+        idx = (join === null || join === void 0 ? void 0 : join.newIndex) || idx;
+        if (join !== null) {
+            const clause = new Clause_1.FromClause(sourceExpression.value, join.value);
+            // Set comments from the FROM token to the clause
+            clause;
+            return { value: clause, newIndex: idx };
+        }
+        else {
+            const clause = new Clause_1.FromClause(sourceExpression.value, null);
+            // Set comments from the FROM token to the clause
+            clause;
+            return { value: clause, newIndex: idx };
+        }
+    }
+}
+exports.FromClauseParser = FromClauseParser;
+//# sourceMappingURL=FromClauseParser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FromClauseParser.js","sourceRoot":"","sources":["../../../src/parsers/FromClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAA8C;AAE9C,iDAA8C;AAC9C,yDAAsD;AACtD,qEAAkE;AAClE,wDAAqD;AAErD,MAAa,gBAAgB;IACzB,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,gEAAgE,CAAC,CAAC;QACvL,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,mDAAmD;QACnD,MAAM,iBAAiB,GAAG,2BAAY,CAAC,qBAAqB,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;QAEnF,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,mDAAmD,CAAC,CAAC;QAClK,CAAC;QACD,GAAG,EAAE,CAAC;QAEN,IAAI,GAAG,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,yGAAyG,CAAC,CAAC;QAC/H,CAAC;QAED,mCAAmC;QACnC,MAAM,gBAAgB,GAAG,+CAAsB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC9E,GAAG,GAAG,gBAAgB,CAAC,QAAQ,CAAC;QAEhC,MAAM,IAAI,GAAG,mCAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACrD,GAAG,GAAG,CAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,KAAI,GAAG,CAAC;QAE5B,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,mBAAU,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAClE,iDAAiD;YACjD,MAAM,CAAA;YACN,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC5C,CAAC;aAAM,CAAC;YACJ,MAAM,MAAM,GAAG,IAAI,mBAAU,CAAC,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YAC5D,iDAAiD;YACjD,MAAM,CAAA;YACN,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;QAC5C,CAAC;IACL,CAAC;CACJ;AApDD,4CAoDC"}

package/dist/src/parsers/FullNameParser.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FullNameParser = void 0;
+const Lexeme_1 = require("../models/Lexeme");
+const ValueComponent_1 = require("../models/ValueComponent");
+const SqlTokenizer_1 = require("./SqlTokenizer");
+/**
+ * Utility class for parsing fully qualified names (e.g. db.schema.table or db.schema.table.column_name)
+ * This can be used for both table and column references.
+ */
+class FullNameParser {
+    /**
+     * Parses a fully qualified name from lexemes, returning namespaces, table, and new index.
+     */
+    static parseFromLexeme(lexemes, index) {
+        const { identifiers, newIndex } = FullNameParser.parseEscapedOrDotSeparatedIdentifiers(lexemes, index);
+        const { namespaces, name } = FullNameParser.extractNamespacesAndName(identifiers);
+        // Create IdentifierString and transfer comments from the last relevant lexeme
+        const identifierString = new ValueComponent_1.IdentifierString(name);
+        // Transfer positioned comments from the last parsed lexeme (the actual table/column name)
+        if (newIndex > index) {
+            const lastLexeme = lexemes[newIndex - 1];
+            if (lastLexeme.positionedComments && lastLexeme.positionedComments.length > 0) {
+                identifierString.positionedComments = lastLexeme.positionedComments;
+            }
+            else if (lastLexeme.comments && lastLexeme.comments.length > 0) {
+                identifierString;
+            }
+        }
+        // Returns the type of the last token in the identifier sequence
+        let lastTokenType = 0;
+        if (newIndex > index) {
+            lastTokenType = lexemes[newIndex - 1].type;
+        }
+        return { namespaces, name: identifierString, newIndex, lastTokenType };
+    }
+    /**
+     * Parses a fully qualified name from a string (e.g. 'db.schema.table')
+     * Returns { namespaces, name }
+     */
+    static parse(str) {
+        const tokenizer = new SqlTokenizer_1.SqlTokenizer(str);
+        const lexemes = tokenizer.readLexmes();
+        const result = this.parseFromLexeme(lexemes, 0);
+        if (result.newIndex < lexemes.length) {
+            // Use a context-agnostic error message since FullNameParser is used in multiple query types
+            throw new Error(`Syntax error: Unexpected token "${lexemes[result.newIndex].value}" at position ${result.newIndex}. The name is complete but additional tokens were found.`);
+        }
+        return { namespaces: result.namespaces, name: result.name };
+    }
+    // Parses SQL Server-style escaped identifiers ([table]) and dot-separated identifiers, including namespaced wildcards (e.g., db.schema.*, [db].[schema].*)
+    static parseEscapedOrDotSeparatedIdentifiers(lexemes, index) {
+        let idx = index;
+        const identifiers = [];
+        while (idx < lexemes.length) {
+            if (lexemes[idx].type & Lexeme_1.TokenType.OpenBracket) {
+                idx++; // skip [
+                if (idx >= lexemes.length || !((lexemes[idx].type & Lexeme_1.TokenType.Identifier) || (lexemes[idx].type & Lexeme_1.TokenType.Command))) {
+                    throw new Error(`Expected identifier after '[' at position ${idx}`);
+                }
+                identifiers.push(lexemes[idx].value);
+                idx++;
+                if (idx >= lexemes.length || lexemes[idx].value !== "]") {
+                    throw new Error(`Expected closing ']' after identifier at position ${idx}`);
+                }
+                idx++; // skip ]
+            }
+            else if (lexemes[idx].type & Lexeme_1.TokenType.Identifier) {
+                identifiers.push(lexemes[idx].value);
+                idx++;
+            }
+            else if (lexemes[idx].type & Lexeme_1.TokenType.Function) {
+                identifiers.push(lexemes[idx].value);
+                idx++;
+            }
+            else if (lexemes[idx].type & Lexeme_1.TokenType.Type) {
+                identifiers.push(lexemes[idx].value);
+                idx++;
+            }
+            else if (lexemes[idx].value === "*") {
+                // The wildcard '*' is always treated as the terminal part of a qualified name in SQL (e.g., db.schema.* or [db].[schema].*).
+                // No valid SQL syntax allows a wildcard in the middle of a multi-part name.
+                identifiers.push(lexemes[idx].value);
+                idx++;
+                break;
+            }
+            // Handle dot for schema.table or db.schema.table
+            if (idx < lexemes.length && (lexemes[idx].type & Lexeme_1.TokenType.Dot)) {
+                idx++; // skip dot
+            }
+            else {
+                break;
+            }
+        }
+        return { identifiers, newIndex: idx };
+    }
+    // Utility to extract namespaces and the final name from an array of identifiers
+    // Example: ["db", "schema", "users"] => { namespaces: ["db", "schema"], name: "users" }
+    static extractNamespacesAndName(identifiers) {
+        if (!identifiers || identifiers.length === 0) {
+            throw new Error("Identifier list is empty");
+        }
+        if (identifiers.length === 1) {
+            return { namespaces: null, name: identifiers[0] };
+        }
+        return { namespaces: identifiers.slice(0, -1), name: identifiers[identifiers.length - 1] };
+    }
+}
+exports.FullNameParser = FullNameParser;
+//# sourceMappingURL=FullNameParser.js.map

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

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