rawsql-ts 0.1.0-beta.1 → 0.1.0-beta.10

package/dist/models/KeywordTrie.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeywordTrie = void 0;
+const KeywordParser_1 = require("../parsers/KeywordParser");
+class KeywordTrie {
+    constructor(keywords) {
+        this.root = new Map();
+        // cache properties
+        this.hasEndProperty = false;
+        this.hasMoreProperties = false;
+        // initialize root node
+        for (const keyword of keywords) {
+            this.addKeyword(keyword);
+        }
+        // set current node to root
+        this.currentNode = this.root;
+    }
+    addKeyword(keyword) {
+        let node = this.root;
+        for (const word of keyword) {
+            if (!node.has(word)) {
+                node.set(word, new Map());
+            }
+            node = node.get(word);
+        }
+        node.set("__end__", true);
+    }
+    reset() {
+        this.currentNode = this.root;
+        this.hasEndProperty = false;
+        this.hasMoreProperties = false;
+    }
+    pushLexeme(lexeme) {
+        if (!this.currentNode.has(lexeme)) {
+            return KeywordParser_1.KeywordMatchResult.NotAKeyword;
+        }
+        // move to next node
+        this.currentNode = this.currentNode.get(lexeme);
+        // Cache property checks to avoid repeated operations
+        this.hasEndProperty = this.currentNode.has("__end__");
+        this.hasMoreProperties = this.currentNode.size > (this.hasEndProperty ? 1 : 0);
+        if (this.hasEndProperty && !this.hasMoreProperties) {
+            return KeywordParser_1.KeywordMatchResult.Final;
+        }
+        if (this.hasEndProperty && this.hasMoreProperties) {
+            return KeywordParser_1.KeywordMatchResult.PartialOrFinal;
+        }
+        return KeywordParser_1.KeywordMatchResult.PartialOnly;
+    }
+}
+exports.KeywordTrie = KeywordTrie;
+//# sourceMappingURL=KeywordTrie.js.map

package/dist/models/KeywordTrie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeywordTrie.js","sourceRoot":"","sources":["../../src/models/KeywordTrie.ts"],"names":[],"mappings":";;;AAAA,4DAA8D;AAE9D,MAAa,WAAW;IAQpB,YAAY,QAAoB;QAPxB,SAAI,GAAqB,IAAI,GAAG,EAAE,CAAC;QAG3C,mBAAmB;QACX,mBAAc,GAAY,KAAK,CAAC;QAChC,sBAAiB,GAAY,KAAK,CAAC;QAGvC,uBAAuB;QACvB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QACD,2BAA2B;QAC3B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;IACjC,CAAC;IAEO,UAAU,CAAC,OAAiB;QAChC,IAAI,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACrB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;YAC9B,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;QAC7B,IAAI,CAAC,cAAc,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;IACnC,CAAC;IAEM,UAAU,CAAC,MAAc;QAC5B,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAChC,OAAO,kCAAkB,CAAC,WAAW,CAAC;QAC1C,CAAC;QAED,oBAAoB;QACpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAEhD,qDAAqD;QACrD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/E,IAAI,IAAI,CAAC,cAAc,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACjD,OAAO,kCAAkB,CAAC,KAAK,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,CAAC,cAAc,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAChD,OAAO,kCAAkB,CAAC,cAAc,CAAC;QAC7C,CAAC;QAED,OAAO,kCAAkB,CAAC,WAAW,CAAC;IAC1C,CAAC;CACJ;AAvDD,kCAuDC"}

package/dist/models/Lexeme.d.ts

@@ -0,0 +1,25 @@
+export declare enum TokenType {
+    Literal = 0,
+    Operator = 1,
+    OpenParen = 2,
+    CloseParen = 3,
+    Comma = 4,
+    Dot = 5,
+    Identifier = 6,
+    Command = 7,// select, from, where as, on, array etc
+    Parameter = 8,
+    OpenBracket = 9,
+    CloseBracket = 10,
+    Function = 11,// next token is open paren
+    StringSpecifier = 12,// next token is string literal
+    Type = 13
+}
+/**
+ * Represents a lexical token in SQL parsing
+ */
+export interface Lexeme {
+    type: TokenType;
+    value: string;
+    comments: string[] | null;
+    maybeType: boolean | null;
+}

package/dist/models/Lexeme.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TokenType = void 0;
+var TokenType;
+(function (TokenType) {
+    TokenType[TokenType["Literal"] = 0] = "Literal";
+    TokenType[TokenType["Operator"] = 1] = "Operator";
+    TokenType[TokenType["OpenParen"] = 2] = "OpenParen";
+    TokenType[TokenType["CloseParen"] = 3] = "CloseParen";
+    TokenType[TokenType["Comma"] = 4] = "Comma";
+    TokenType[TokenType["Dot"] = 5] = "Dot";
+    TokenType[TokenType["Identifier"] = 6] = "Identifier";
+    TokenType[TokenType["Command"] = 7] = "Command";
+    TokenType[TokenType["Parameter"] = 8] = "Parameter";
+    TokenType[TokenType["OpenBracket"] = 9] = "OpenBracket";
+    TokenType[TokenType["CloseBracket"] = 10] = "CloseBracket";
+    TokenType[TokenType["Function"] = 11] = "Function";
+    TokenType[TokenType["StringSpecifier"] = 12] = "StringSpecifier";
+    TokenType[TokenType["Type"] = 13] = "Type";
+})(TokenType || (exports.TokenType = TokenType = {}));
+//# sourceMappingURL=Lexeme.js.map

package/dist/models/Lexeme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Lexeme.js","sourceRoot":"","sources":["../../src/models/Lexeme.ts"],"names":[],"mappings":";;;AAAA,IAAY,SAeX;AAfD,WAAY,SAAS;IACjB,+CAAO,CAAA;IACP,iDAAQ,CAAA;IACR,mDAAS,CAAA;IACT,qDAAU,CAAA;IACV,2CAAK,CAAA;IACL,uCAAG,CAAA;IACH,qDAAU,CAAA;IACV,+CAAO,CAAA;IACP,mDAAS,CAAA;IACT,uDAAW,CAAA;IACX,0DAAY,CAAA;IACZ,kDAAQ,CAAA;IACR,gEAAe,CAAA;IACf,0CAAI,CAAA;AACR,CAAC,EAfW,SAAS,yBAAT,SAAS,QAepB"}

package/dist/models/SelectQuery.d.ts

@@ -0,0 +1,5 @@
+import { SimpleSelectQuery } from "./SimpleSelectQuery";
+import { BinarySelectQuery } from "./BinarySelectQuery";
+import { ValuesQuery } from "./ValuesQuery";
+export type SelectQuery = SimpleSelectQuery | BinarySelectQuery | ValuesQuery;
+export { SimpleSelectQuery, BinarySelectQuery, ValuesQuery };

package/dist/models/SelectQuery.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValuesQuery = exports.BinarySelectQuery = exports.SimpleSelectQuery = void 0;
+const SimpleSelectQuery_1 = require("./SimpleSelectQuery");
+Object.defineProperty(exports, "SimpleSelectQuery", { enumerable: true, get: function () { return SimpleSelectQuery_1.SimpleSelectQuery; } });
+const BinarySelectQuery_1 = require("./BinarySelectQuery");
+Object.defineProperty(exports, "BinarySelectQuery", { enumerable: true, get: function () { return BinarySelectQuery_1.BinarySelectQuery; } });
+const ValuesQuery_1 = require("./ValuesQuery");
+Object.defineProperty(exports, "ValuesQuery", { enumerable: true, get: function () { return ValuesQuery_1.ValuesQuery; } });
+//# sourceMappingURL=SelectQuery.js.map

package/dist/models/SelectQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelectQuery.js","sourceRoot":"","sources":["../../src/models/SelectQuery.ts"],"names":[],"mappings":";;;AAAA,2DAAwD;AAK/C,kGALA,qCAAiB,OAKA;AAJ1B,2DAAwD;AAI5B,kGAJnB,qCAAiB,OAImB;AAH7C,+CAA4C;AAGG,4FAHtC,yBAAW,OAGsC"}

package/dist/models/SimpleSelectQuery.d.ts

@@ -0,0 +1,167 @@
+import { SqlComponent } from "./SqlComponent";
+import { ForClause, FromClause, GroupByClause, HavingClause, LimitClause, OrderByClause, SelectClause, SourceExpression, WhereClause, WindowFrameClause, WithClause, CommonTable } from "./Clause";
+import { ValueComponent } from "./ValueComponent";
+import { BinarySelectQuery } from "./BinarySelectQuery";
+import type { SelectQuery } from "./SelectQuery";
+/**
+ * Represents a simple SELECT query in SQL.
+ */
+export declare class SimpleSelectQuery extends SqlComponent {
+    static kind: symbol;
+    WithClause: WithClause | null;
+    selectClause: SelectClause;
+    fromClause: FromClause | null;
+    whereClause: WhereClause | null;
+    groupByClause: GroupByClause | null;
+    havingClause: HavingClause | null;
+    orderByClause: OrderByClause | null;
+    windowFrameClause: WindowFrameClause | null;
+    rowLimitClause: LimitClause | null;
+    forClause: ForClause | null;
+    constructor(withClause: WithClause | null, selectClause: SelectClause, fromClause: FromClause | null, whereClause: WhereClause | null, groupByClause: GroupByClause | null, havingClause: HavingClause | null, orderByClause: OrderByClause | null, windowFrameClause: WindowFrameClause | null, rowLimitClause: LimitClause | null, forClause: ForClause | null);
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using UNION as the operator.
+     *
+     * @param rightQuery The right side of the UNION
+     * @returns A new BinarySelectQuery representing "this UNION rightQuery"
+     */
+    toUnion(rightQuery: SelectQuery): BinarySelectQuery;
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using UNION ALL as the operator.
+     *
+     * @param rightQuery The right side of the UNION ALL
+     * @returns A new BinarySelectQuery representing "this UNION ALL rightQuery"
+     */
+    toUnionAll(rightQuery: SelectQuery): BinarySelectQuery;
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using INTERSECT as the operator.
+     *
+     * @param rightQuery The right side of the INTERSECT
+     * @returns A new BinarySelectQuery representing "this INTERSECT rightQuery"
+     */
+    toIntersect(rightQuery: SelectQuery): BinarySelectQuery;
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using INTERSECT ALL as the operator.
+     *
+     * @param rightQuery The right side of the INTERSECT ALL
+     * @returns A new BinarySelectQuery representing "this INTERSECT ALL rightQuery"
+     */
+    toIntersectAll(rightQuery: SelectQuery): BinarySelectQuery;
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using EXCEPT as the operator.
+     *
+     * @param rightQuery The right side of the EXCEPT
+     * @returns A new BinarySelectQuery representing "this EXCEPT rightQuery"
+     */
+    toExcept(rightQuery: SelectQuery): BinarySelectQuery;
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using EXCEPT ALL as the operator.
+     *
+     * @param rightQuery The right side of the EXCEPT ALL
+     * @returns A new BinarySelectQuery representing "this EXCEPT ALL rightQuery"
+     */
+    toExceptAll(rightQuery: SelectQuery): BinarySelectQuery;
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using the specified operator.
+     *
+     * @param operator SQL operator to use (e.g. 'union', 'union all', 'intersect', 'except')
+     * @param rightQuery The right side of the binary operation
+     * @returns A new BinarySelectQuery representing "this [operator] rightQuery"
+     */
+    toBinaryQuery(operator: string, rightQuery: SelectQuery): BinarySelectQuery;
+    /**
+     * Appends a new condition to the query's WHERE clause using AND logic.
+     * The condition is provided as a raw SQL string which is parsed internally.
+     *
+     * @param rawCondition Raw SQL string representing the condition (e.g. "status = 'active'")
+     */
+    appendWhereRaw(rawCondition: string): void;
+    /**
+     * Appends a new condition to the query's WHERE clause using AND logic.
+     * The condition is provided as a ValueComponent object.
+     *
+     * @param condition ValueComponent representing the condition
+     */
+    appendWhere(condition: ValueComponent): void;
+    /**
+     * Appends a new condition to the query's HAVING clause using AND logic.
+     * The condition is provided as a raw SQL string which is parsed internally.
+     *
+     * @param rawCondition Raw SQL string representing the condition (e.g. "count(*) > 5")
+     */
+    appendHavingRaw(rawCondition: string): void;
+    /**
+     * Appends a new condition to the query's HAVING clause using AND logic.
+     * The condition is provided as a ValueComponent object.
+     *
+     * @param condition ValueComponent representing the condition
+     */
+    appendHaving(condition: ValueComponent): void;
+    /**
+     * Appends an INNER JOIN clause to the query.
+     * @param joinSourceRawText The table source text to join (e.g., "my_table", "schema.my_table")
+     * @param alias The alias for the joined table
+     * @param columns The columns to use for the join condition (e.g. ["user_id"])
+     */
+    innerJoinRaw(joinSourceRawText: string, alias: string, columns: string[]): void;
+    /**
+     * Appends a LEFT JOIN clause to the query.
+     * @param joinSourceRawText The table source text to join
+     * @param alias The alias for the joined table
+     * @param columns The columns to use for the join condition
+     */
+    leftJoinRaw(joinSourceRawText: string, alias: string, columns: string[]): void;
+    /**
+     * Appends a RIGHT JOIN clause to the query.
+     * @param joinSourceRawText The table source text to join
+     * @param alias The alias for the joined table
+     * @param columns The columns to use for the join condition
+     */
+    rightJoinRaw(joinSourceRawText: string, alias: string, columns: string[]): void;
+    /**
+     * Appends an INNER JOIN clause to the query using a SourceExpression.
+     * @param sourceExpr The source expression to join
+     * @param columns The columns to use for the join condition
+     */
+    innerJoin(sourceExpr: SourceExpression, columns: string[]): void;
+    /**
+     * Appends a LEFT JOIN clause to the query using a SourceExpression.
+     * @param sourceExpr The source expression to join
+     * @param columns The columns to use for the join condition
+     */
+    leftJoin(sourceExpr: SourceExpression, columns: string[]): void;
+    /**
+     * Appends a RIGHT JOIN clause to the query using a SourceExpression.
+     * @param sourceExpr The source expression to join
+     * @param columns The columns to use for the join condition
+     */
+    rightJoin(sourceExpr: SourceExpression, columns: string[]): void;
+    /**
+     * Internal helper to append a JOIN clause.
+     * Parses the table source, finds the corresponding columns in the existing query context,
+     * and builds the JOIN condition.
+     * @param joinType Type of join (e.g., 'inner join', 'left join')
+     * @param joinSourceRawText Raw text for the table/source to join (e.g., "my_table", "schema.another_table")
+     * @param alias Alias for the table/source being joined
+     * @param columns Array of column names to join on
+     */
+    private joinSourceRaw;
+    private joinSource;
+    toSource(alias: string): SourceExpression;
+    appendWith(commonTable: CommonTable | CommonTable[]): void;
+    /**
+     * Appends a CommonTable (CTE) to the WITH clause from raw SQL text and alias.
+     * If alias is provided, it will be used as the CTE name.
+     *
+     * @param rawText Raw SQL string representing the CTE body (e.g. '(SELECT ...)')
+     * @param alias Optional alias for the CTE (e.g. 'cte_name')
+     */
+    appendWithRaw(rawText: string, alias: string): void;
+}

package/dist/models/SimpleSelectQuery.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SimpleSelectQuery = void 0;
+const SqlComponent_1 = require("./SqlComponent");
+const Clause_1 = require("./Clause");
+const ValueComponent_1 = require("./ValueComponent");
+const ValueParser_1 = require("../parsers/ValueParser");
+const CTENormalizer_1 = require("../transformers/CTENormalizer");
+const SelectableColumnCollector_1 = require("../transformers/SelectableColumnCollector");
+const SourceParser_1 = require("../parsers/SourceParser");
+const BinarySelectQuery_1 = require("./BinarySelectQuery");
+const SelectQueryParser_1 = require("../parsers/SelectQueryParser");
+/**
+ * Represents a simple SELECT query in SQL.
+ */
+class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
+    constructor(withClause, selectClause, fromClause, whereClause, groupByClause, havingClause, orderByClause, windowFrameClause, rowLimitClause, forClause) {
+        super();
+        this.WithClause = null;
+        this.WithClause = withClause;
+        this.selectClause = selectClause;
+        this.fromClause = fromClause;
+        this.whereClause = whereClause;
+        this.groupByClause = groupByClause;
+        this.havingClause = havingClause;
+        this.orderByClause = orderByClause;
+        this.windowFrameClause = windowFrameClause;
+        this.rowLimitClause = rowLimitClause;
+        this.forClause = forClause;
+    }
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using UNION as the operator.
+     *
+     * @param rightQuery The right side of the UNION
+     * @returns A new BinarySelectQuery representing "this UNION rightQuery"
+     */
+    toUnion(rightQuery) {
+        return this.toBinaryQuery('union', rightQuery);
+    }
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using UNION ALL as the operator.
+     *
+     * @param rightQuery The right side of the UNION ALL
+     * @returns A new BinarySelectQuery representing "this UNION ALL rightQuery"
+     */
+    toUnionAll(rightQuery) {
+        return this.toBinaryQuery('union all', rightQuery);
+    }
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using INTERSECT as the operator.
+     *
+     * @param rightQuery The right side of the INTERSECT
+     * @returns A new BinarySelectQuery representing "this INTERSECT rightQuery"
+     */
+    toIntersect(rightQuery) {
+        return this.toBinaryQuery('intersect', rightQuery);
+    }
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using INTERSECT ALL as the operator.
+     *
+     * @param rightQuery The right side of the INTERSECT ALL
+     * @returns A new BinarySelectQuery representing "this INTERSECT ALL rightQuery"
+     */
+    toIntersectAll(rightQuery) {
+        return this.toBinaryQuery('intersect all', rightQuery);
+    }
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using EXCEPT as the operator.
+     *
+     * @param rightQuery The right side of the EXCEPT
+     * @returns A new BinarySelectQuery representing "this EXCEPT rightQuery"
+     */
+    toExcept(rightQuery) {
+        return this.toBinaryQuery('except', rightQuery);
+    }
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using EXCEPT ALL as the operator.
+     *
+     * @param rightQuery The right side of the EXCEPT ALL
+     * @returns A new BinarySelectQuery representing "this EXCEPT ALL rightQuery"
+     */
+    toExceptAll(rightQuery) {
+        return this.toBinaryQuery('except all', rightQuery);
+    }
+    /**
+     * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
+     * using the specified operator.
+     *
+     * @param operator SQL operator to use (e.g. 'union', 'union all', 'intersect', 'except')
+     * @param rightQuery The right side of the binary operation
+     * @returns A new BinarySelectQuery representing "this [operator] rightQuery"
+     */
+    toBinaryQuery(operator, rightQuery) {
+        return new BinarySelectQuery_1.BinarySelectQuery(this, operator, rightQuery);
+    }
+    /**
+     * Appends a new condition to the query's WHERE clause using AND logic.
+     * The condition is provided as a raw SQL string which is parsed internally.
+     *
+     * @param rawCondition Raw SQL string representing the condition (e.g. "status = 'active'")
+     */
+    appendWhereRaw(rawCondition) {
+        const parsedCondition = ValueParser_1.ValueParser.parse(rawCondition);
+        this.appendWhere(parsedCondition);
+    }
+    /**
+     * Appends a new condition to the query's WHERE clause using AND logic.
+     * The condition is provided as a ValueComponent object.
+     *
+     * @param condition ValueComponent representing the condition
+     */
+    appendWhere(condition) {
+        if (!this.whereClause) {
+            this.whereClause = new Clause_1.WhereClause(condition);
+        }
+        else {
+            this.whereClause.condition = new ValueComponent_1.BinaryExpression(this.whereClause.condition, 'and', condition);
+        }
+    }
+    /**
+     * Appends a new condition to the query's HAVING clause using AND logic.
+     * The condition is provided as a raw SQL string which is parsed internally.
+     *
+     * @param rawCondition Raw SQL string representing the condition (e.g. "count(*) > 5")
+     */
+    appendHavingRaw(rawCondition) {
+        const parsedCondition = ValueParser_1.ValueParser.parse(rawCondition);
+        this.appendHaving(parsedCondition);
+    }
+    /**
+     * Appends a new condition to the query's HAVING clause using AND logic.
+     * The condition is provided as a ValueComponent object.
+     *
+     * @param condition ValueComponent representing the condition
+     */
+    appendHaving(condition) {
+        if (!this.havingClause) {
+            this.havingClause = new Clause_1.HavingClause(condition);
+        }
+        else {
+            this.havingClause.condition = new ValueComponent_1.BinaryExpression(this.havingClause.condition, 'and', condition);
+        }
+    }
+    /**
+     * Appends an INNER JOIN clause to the query.
+     * @param joinSourceRawText The table source text to join (e.g., "my_table", "schema.my_table")
+     * @param alias The alias for the joined table
+     * @param columns The columns to use for the join condition (e.g. ["user_id"])
+     */
+    innerJoinRaw(joinSourceRawText, alias, columns) {
+        this.joinSourceRaw('inner join', joinSourceRawText, alias, columns);
+    }
+    /**
+     * Appends a LEFT JOIN clause to the query.
+     * @param joinSourceRawText The table source text to join
+     * @param alias The alias for the joined table
+     * @param columns The columns to use for the join condition
+     */
+    leftJoinRaw(joinSourceRawText, alias, columns) {
+        this.joinSourceRaw('left join', joinSourceRawText, alias, columns);
+    }
+    /**
+     * Appends a RIGHT JOIN clause to the query.
+     * @param joinSourceRawText The table source text to join
+     * @param alias The alias for the joined table
+     * @param columns The columns to use for the join condition
+     */
+    rightJoinRaw(joinSourceRawText, alias, columns) {
+        this.joinSourceRaw('right join', joinSourceRawText, alias, columns);
+    }
+    /**
+     * Appends an INNER JOIN clause to the query using a SourceExpression.
+     * @param sourceExpr The source expression to join
+     * @param columns The columns to use for the join condition
+     */
+    innerJoin(sourceExpr, columns) {
+        this.joinSource('inner join', sourceExpr, columns);
+    }
+    /**
+     * Appends a LEFT JOIN clause to the query using a SourceExpression.
+     * @param sourceExpr The source expression to join
+     * @param columns The columns to use for the join condition
+     */
+    leftJoin(sourceExpr, columns) {
+        this.joinSource('left join', sourceExpr, columns);
+    }
+    /**
+     * Appends a RIGHT JOIN clause to the query using a SourceExpression.
+     * @param sourceExpr The source expression to join
+     * @param columns The columns to use for the join condition
+     */
+    rightJoin(sourceExpr, columns) {
+        this.joinSource('right join', sourceExpr, columns);
+    }
+    /**
+     * Internal helper to append a JOIN clause.
+     * Parses the table source, finds the corresponding columns in the existing query context,
+     * and builds the JOIN condition.
+     * @param joinType Type of join (e.g., 'inner join', 'left join')
+     * @param joinSourceRawText Raw text for the table/source to join (e.g., "my_table", "schema.another_table")
+     * @param alias Alias for the table/source being joined
+     * @param columns Array of column names to join on
+     */
+    joinSourceRaw(joinType, joinSourceRawText, alias, columns) {
+        const tableSource = SourceParser_1.SourceParser.parse(joinSourceRawText);
+        const sourceExpr = new Clause_1.SourceExpression(tableSource, new Clause_1.SourceAliasExpression(alias, null));
+        this.joinSource(joinType, sourceExpr, columns);
+    }
+    joinSource(joinType, sourceExpr, columns) {
+        if (!this.fromClause) {
+            throw new Error('A FROM clause is required to add a JOIN condition.');
+        }
+        const collector = new SelectableColumnCollector_1.SelectableColumnCollector();
+        const valueSets = collector.collect(this);
+        let joinCondition = null;
+        let count = 0;
+        const sourceAlias = sourceExpr.getAliasName();
+        if (!sourceAlias) {
+            throw new Error('An alias is required for the source expression to add a JOIN condition.');
+        }
+        for (const valueSet of valueSets) {
+            if (columns.some(col => col == valueSet.name)) {
+                const expr = new ValueComponent_1.BinaryExpression(valueSet.value, '=', new ValueComponent_1.ColumnReference([sourceAlias], valueSet.name));
+                if (joinCondition) {
+                    joinCondition = new ValueComponent_1.BinaryExpression(joinCondition, 'and', expr);
+                }
+                else {
+                    joinCondition = expr;
+                }
+                count++;
+            }
+        }
+        if (!joinCondition || count !== columns.length) {
+            throw new Error(`Invalid JOIN condition. The specified columns were not found: ${columns.join(', ')}`);
+        }
+        const joinOnClause = new Clause_1.JoinOnClause(joinCondition);
+        const joinClause = new Clause_1.JoinClause(joinType, sourceExpr, joinOnClause, false);
+        if (this.fromClause) {
+            if (this.fromClause.joins) {
+                this.fromClause.joins.push(joinClause);
+            }
+            else {
+                this.fromClause.joins = [joinClause];
+            }
+        }
+        // const normalizer = new CTENormalizer();
+        // normalizer.normalize(this);
+        CTENormalizer_1.CTENormalizer.normalize(this);
+    }
+    // Returns a SourceExpression wrapping this query as a subquery source.
+    // Alias is required for correct SQL generation and join logic.
+    toSource(alias) {
+        if (!alias || alias.trim() === "") {
+            throw new Error("Alias is required for toSource(). Please specify a non-empty alias name.");
+        }
+        return new Clause_1.SourceExpression(new Clause_1.SubQuerySource(this), new Clause_1.SourceAliasExpression(alias, null));
+    }
+    appendWith(commonTable) {
+        // Always treat as array for simplicity
+        const tables = Array.isArray(commonTable) ? commonTable : [commonTable];
+        if (!this.WithClause) {
+            this.WithClause = new Clause_1.WithClause(false, tables);
+        }
+        else {
+            this.WithClause.tables.push(...tables);
+        }
+        // const normalizer = new CTENormalizer();
+        // normalizer.normalize(this);
+        CTENormalizer_1.CTENormalizer.normalize(this);
+    }
+    /**
+     * Appends a CommonTable (CTE) to the WITH clause from raw SQL text and alias.
+     * If alias is provided, it will be used as the CTE name.
+     *
+     * @param rawText Raw SQL string representing the CTE body (e.g. '(SELECT ...)')
+     * @param alias Optional alias for the CTE (e.g. 'cte_name')
+     */
+    appendWithRaw(rawText, alias) {
+        const query = SelectQueryParser_1.SelectQueryParser.parse(rawText);
+        const commonTable = new Clause_1.CommonTable(query, alias, null);
+        this.appendWith(commonTable);
+    }
+}
+exports.SimpleSelectQuery = SimpleSelectQuery;
+SimpleSelectQuery.kind = Symbol("SelectQuery");
+//# sourceMappingURL=SimpleSelectQuery.js.map

package/dist/models/SimpleSelectQuery.js.map

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

package/dist/models/SqlComponent.d.ts

@@ -0,0 +1,18 @@
+export declare abstract class SqlComponent {
+    static kind: symbol;
+    getKind(): symbol;
+    accept<T>(visitor: SqlComponentVisitor<T>): T;
+    toSqlString(formatter: SqlComponentVisitor<string>): string;
+    comments: string[] | null;
+}
+export interface SqlComponentVisitor<T> {
+    visit(expr: SqlComponent): T;
+}
+export declare class SqlDialectConfiguration {
+    parameterSymbol: string;
+    identifierEscape: {
+        start: string;
+        end: string;
+    };
+    exportComment: boolean;
+}

package/dist/models/SqlComponent.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SqlDialectConfiguration = exports.SqlComponent = void 0;
+class SqlComponent {
+    constructor() {
+        this.comments = null;
+    }
+    getKind() {
+        return this.constructor.kind;
+    }
+    accept(visitor) {
+        return visitor.visit(this);
+    }
+    toSqlString(formatter) {
+        return this.accept(formatter);
+    }
+}
+exports.SqlComponent = SqlComponent;
+class SqlDialectConfiguration {
+    constructor() {
+        this.parameterSymbol = ":";
+        this.identifierEscape = { start: '"', end: '"' };
+        this.exportComment = true;
+    }
+}
+exports.SqlDialectConfiguration = SqlDialectConfiguration;
+//# sourceMappingURL=SqlComponent.js.map

package/dist/models/SqlComponent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqlComponent.js","sourceRoot":"","sources":["../../src/models/SqlComponent.ts"],"names":[],"mappings":";;;AAAA,MAAsB,YAAY;IAAlC;QAgBI,aAAQ,GAAoB,IAAI,CAAC;IACrC,CAAC;IAbG,OAAO;QACH,OAAQ,IAAI,CAAC,WAAmC,CAAC,IAAI,CAAC;IAC1D,CAAC;IAED,MAAM,CAAI,OAA+B;QACrC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,WAAW,CAAC,SAAsC;QAC9C,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;CAGJ;AAjBD,oCAiBC;AAMD,MAAa,uBAAuB;IAApC;QACW,oBAAe,GAAW,GAAG,CAAC;QAC9B,qBAAgB,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QAC5C,kBAAa,GAAY,IAAI,CAAC;IACzC,CAAC;CAAA;AAJD,0DAIC"}