rawsql-ts 0.11.2-beta → 0.11.3-beta

package/dist/src/index.d.ts

@@ -4,6 +4,7 @@ export * from './models/BinarySelectQuery';
 export * from './models/SelectQuery';
 export * from './models/ValueComponent';
 export * from './models/ValuesQuery';
+export * from './models/CTEError';
 export * from './transformers/CTECollector';
 export * from './transformers/CTENormalizer';
 export * from './transformers/Formatter';

package/dist/src/index.js

@@ -22,6 +22,7 @@ __exportStar(require("./models/BinarySelectQuery"), exports);
 __exportStar(require("./models/SelectQuery"), exports);
 __exportStar(require("./models/ValueComponent"), exports);
 __exportStar(require("./models/ValuesQuery"), exports);
+__exportStar(require("./models/CTEError"), exports);
 __exportStar(require("./transformers/CTECollector"), exports);
 __exportStar(require("./transformers/CTENormalizer"), exports);
 __exportStar(require("./transformers/Formatter"), exports);

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8DAA4C;AAC5C,8DAA4C;AAE5C,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AAErC,8DAA4C;AAC5C,+DAA6C;AAC7C,2DAAyC;AACzC,8DAA4C;AAC5C,0EAAwD;AACxD,8DAA4C,CAAC,0BAA0B;AACvE,sEAAoD;AACpD,2EAAyD;AACzD,qEAAmD;AACnD,sEAAoD;AACpD,sEAAoD;AACpD,qEAAmD;AACnD,gFAQ+C;AAN3C,mIAAA,yBAAyB,OAAA;AACzB,oIAAA,0BAA0B,OAAA;AAM9B,wEAM2C;AALvC,6DAA6D;AAC7D,wHAAA,kBAAkB,OAAA;AAClB,yHAAA,mBAAmB,OAAA;AACnB,qHAAA,eAAe,OAAA;AACf,oHAAA,cAAc,OAAA;AAGlB,qEAAqE;AACrE,wEAAqE;AAA5D,sHAAA,gBAAgB,OAAA;AACzB,2EAAyD;AACzD,iFAA+D;AAE/D,iEAA+C;AAC/C,kEAAgD;AAChD,iEAA+C;AAC/C,uEAAqD;AACrD,qEAAmD;AAEnD,6DAA2C;AAC3C,8DAA4C;AAC5C,wDAAsC;AACtC,oEAAoE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8DAA4C;AAC5C,8DAA4C;AAE5C,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AACrC,oDAAkC;AAElC,8DAA4C;AAC5C,+DAA6C;AAC7C,2DAAyC;AACzC,8DAA4C;AAC5C,0EAAwD;AACxD,8DAA4C,CAAC,0BAA0B;AACvE,sEAAoD;AACpD,2EAAyD;AACzD,qEAAmD;AACnD,sEAAoD;AACpD,sEAAoD;AACpD,qEAAmD;AACnD,gFAQ+C;AAN3C,mIAAA,yBAAyB,OAAA;AACzB,oIAAA,0BAA0B,OAAA;AAM9B,wEAM2C;AALvC,6DAA6D;AAC7D,wHAAA,kBAAkB,OAAA;AAClB,yHAAA,mBAAmB,OAAA;AACnB,qHAAA,eAAe,OAAA;AACf,oHAAA,cAAc,OAAA;AAGlB,qEAAqE;AACrE,wEAAqE;AAA5D,sHAAA,gBAAgB,OAAA;AACzB,2EAAyD;AACzD,iFAA+D;AAE/D,iEAA+C;AAC/C,kEAAgD;AAChD,iEAA+C;AAC/C,uEAAqD;AACrD,qEAAmD;AAEnD,6DAA2C;AAC3C,8DAA4C;AAC5C,wDAAsC;AACtC,oEAAoE"}

package/dist/src/models/BinarySelectQuery.d.ts

@@ -2,6 +2,7 @@ import { SourceExpression } from "./Clause";
 import type { SelectQuery } from "./SelectQuery";
 import { SqlComponent } from "./SqlComponent";
 import { RawString } from "./ValueComponent";
+import { SimpleSelectQuery } from "./SimpleSelectQuery";
 /**
  * Represents a binary SELECT query (e.g., UNION, INTERSECT, EXCEPT).
  */
@@ -94,4 +95,10 @@ export declare class BinarySelectQuery extends SqlComponent implements SelectQue
      * @param value Value to set
      */
     setParameter(name: string, value: any): this;
+    /**
+     * Converts this BinarySelectQuery to a SimpleSelectQuery using QueryBuilder.
+     * This enables CTE management on binary queries by wrapping them as subqueries.
+     * @returns A SimpleSelectQuery representation of this binary query
+     */
+    toSimpleQuery(): SimpleSelectQuery;
 }

package/dist/src/models/BinarySelectQuery.js

@@ -7,6 +7,7 @@ const ValueComponent_1 = require("./ValueComponent");
 const CTENormalizer_1 = require("../transformers/CTENormalizer");
 const SelectQueryParser_1 = require("../parsers/SelectQueryParser");
 const ParameterHelper_1 = require("../utils/ParameterHelper");
+const QueryBuilder_1 = require("../transformers/QueryBuilder");
 /**
  * Represents a binary SELECT query (e.g., UNION, INTERSECT, EXCEPT).
  */
@@ -143,6 +144,14 @@ class BinarySelectQuery extends SqlComponent_1.SqlComponent {
         ParameterHelper_1.ParameterHelper.set(this, name, value);
         return this;
     }
+    /**
+     * Converts this BinarySelectQuery to a SimpleSelectQuery using QueryBuilder.
+     * This enables CTE management on binary queries by wrapping them as subqueries.
+     * @returns A SimpleSelectQuery representation of this binary query
+     */
+    toSimpleQuery() {
+        return QueryBuilder_1.QueryBuilder.buildSimpleQuery(this);
+    }
 }
 exports.BinarySelectQuery = BinarySelectQuery;
 BinarySelectQuery.kind = Symbol("BinarySelectQuery");

package/dist/src/models/BinarySelectQuery.js.map

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

package/dist/src/models/CTEError.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Error thrown when a CTE with the same name already exists
+ */
+export declare class DuplicateCTEError extends Error {
+    cteName: string;
+    constructor(cteName: string);
+}
+/**
+ * Error thrown when a CTE name is invalid
+ */
+export declare class InvalidCTENameError extends Error {
+    cteName: string;
+    constructor(cteName: string, reason: string);
+}
+/**
+ * Error thrown when trying to operate on a non-existent CTE
+ */
+export declare class CTENotFoundError extends Error {
+    cteName: string;
+    constructor(cteName: string);
+}

package/dist/src/models/CTEError.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CTENotFoundError = exports.InvalidCTENameError = exports.DuplicateCTEError = void 0;
+/**
+ * Error thrown when a CTE with the same name already exists
+ */
+class DuplicateCTEError extends Error {
+    constructor(cteName) {
+        super(`CTE '${cteName}' already exists in the query`);
+        this.cteName = cteName;
+        this.name = 'DuplicateCTEError';
+    }
+}
+exports.DuplicateCTEError = DuplicateCTEError;
+/**
+ * Error thrown when a CTE name is invalid
+ */
+class InvalidCTENameError extends Error {
+    constructor(cteName, reason) {
+        super(`Invalid CTE name '${cteName}': ${reason}`);
+        this.cteName = cteName;
+        this.name = 'InvalidCTENameError';
+    }
+}
+exports.InvalidCTENameError = InvalidCTENameError;
+/**
+ * Error thrown when trying to operate on a non-existent CTE
+ */
+class CTENotFoundError extends Error {
+    constructor(cteName) {
+        super(`CTE '${cteName}' not found in the query`);
+        this.cteName = cteName;
+        this.name = 'CTENotFoundError';
+    }
+}
+exports.CTENotFoundError = CTENotFoundError;
+//# sourceMappingURL=CTEError.js.map

package/dist/src/models/CTEError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CTEError.js","sourceRoot":"","sources":["../../../src/models/CTEError.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,iBAAkB,SAAQ,KAAK;IACxC,YAAmB,OAAe;QAC9B,KAAK,CAAC,QAAQ,OAAO,+BAA+B,CAAC,CAAC;QADvC,YAAO,GAAP,OAAO,CAAQ;QAE9B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IACpC,CAAC;CACJ;AALD,8CAKC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC1C,YAAmB,OAAe,EAAE,MAAc;QAC9C,KAAK,CAAC,qBAAqB,OAAO,MAAM,MAAM,EAAE,CAAC,CAAC;QADnC,YAAO,GAAP,OAAO,CAAQ;QAE9B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACtC,CAAC;CACJ;AALD,kDAKC;AAED;;GAEG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACvC,YAAmB,OAAe;QAC9B,KAAK,CAAC,QAAQ,OAAO,0BAA0B,CAAC,CAAC;QADlC,YAAO,GAAP,OAAO,CAAQ;QAE9B,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ;AALD,4CAKC"}

package/dist/src/models/SelectQuery.d.ts

@@ -3,7 +3,19 @@ import { InsertQuery } from "./InsertQuery";
 import { SimpleSelectQuery } from "./SimpleSelectQuery";
 import { BinarySelectQuery } from "./BinarySelectQuery";
 import { ValuesQuery } from "./ValuesQuery";
+export interface CTEOptions {
+    materialized?: boolean | null;
+}
+export { DuplicateCTEError, InvalidCTENameError, CTENotFoundError } from './CTEError';
+export interface CTEManagement {
+    addCTE(name: string, query: SelectQuery, options?: CTEOptions): this;
+    removeCTE(name: string): this;
+    hasCTE(name: string): boolean;
+    getCTENames(): string[];
+    replaceCTE(name: string, query: SelectQuery, options?: CTEOptions): this;
+}
 export interface SelectQuery extends SqlComponent {
     setParameter(name: string, value: any): this;
+    toSimpleQuery(): SimpleSelectQuery;
 }
 export { SimpleSelectQuery, BinarySelectQuery, ValuesQuery, InsertQuery };

package/dist/src/models/SelectQuery.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.InsertQuery = exports.ValuesQuery = exports.BinarySelectQuery = exports.SimpleSelectQuery = void 0;
+exports.InsertQuery = exports.ValuesQuery = exports.BinarySelectQuery = exports.SimpleSelectQuery = exports.CTENotFoundError = exports.InvalidCTENameError = exports.DuplicateCTEError = void 0;
 const InsertQuery_1 = require("./InsertQuery");
 Object.defineProperty(exports, "InsertQuery", { enumerable: true, get: function () { return InsertQuery_1.InsertQuery; } });
 const SimpleSelectQuery_1 = require("./SimpleSelectQuery");
@@ -9,4 +9,8 @@ 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; } });
+var CTEError_1 = require("./CTEError");
+Object.defineProperty(exports, "DuplicateCTEError", { enumerable: true, get: function () { return CTEError_1.DuplicateCTEError; } });
+Object.defineProperty(exports, "InvalidCTENameError", { enumerable: true, get: function () { return CTEError_1.InvalidCTENameError; } });
+Object.defineProperty(exports, "CTENotFoundError", { enumerable: true, get: function () { return CTEError_1.CTENotFoundError; } });
 //# sourceMappingURL=SelectQuery.js.map

package/dist/src/models/SelectQuery.js.map

@@ -1 +1 @@
-{"version":3,"file":"SelectQuery.js","sourceRoot":"","sources":["../../../src/models/SelectQuery.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAQgB,4FARnD,yBAAW,OAQmD;AAPvE,2DAAwD;AAO/C,kGAPA,qCAAiB,OAOA;AAN1B,2DAAwD;AAM5B,kGANnB,qCAAiB,OAMmB;AAL7C,+CAA4C;AAKG,4FALtC,yBAAW,OAKsC"}
+{"version":3,"file":"SelectQuery.js","sourceRoot":"","sources":["../../../src/models/SelectQuery.ts"],"names":[],"mappings":";;;AACA,+CAA4C;AAuBgB,4FAvBnD,yBAAW,OAuBmD;AAtBvE,2DAAwD;AAsB/C,kGAtBA,qCAAiB,OAsBA;AArB1B,2DAAwD;AAqB5B,kGArBnB,qCAAiB,OAqBmB;AApB7C,+CAA4C;AAoBG,4FApBtC,yBAAW,OAoBsC;AAd1D,uCAAsF;AAA7E,6GAAA,iBAAiB,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAAE,4GAAA,gBAAgB,OAAA"}

package/dist/src/models/SimpleSelectQuery.d.ts

@@ -2,12 +2,12 @@ import { SqlComponent } from "./SqlComponent";
 import { ForClause, FromClause, GroupByClause, HavingClause, LimitClause, OrderByClause, SelectClause, SourceExpression, WhereClause, WindowsClause as WindowClause, WithClause, CommonTable, OffsetClause, FetchClause } from "./Clause";
 import { ValueComponent } from "./ValueComponent";
 import { BinarySelectQuery } from "./BinarySelectQuery";
-import type { SelectQuery } from "./SelectQuery";
+import type { SelectQuery, CTEOptions, CTEManagement } from "./SelectQuery";
 import { TableColumnResolver } from "../transformers/TableColumnResolver";
 /**
  * Represents a simple SELECT query in SQL.
  */
-export declare class SimpleSelectQuery extends SqlComponent implements SelectQuery {
+export declare class SimpleSelectQuery extends SqlComponent implements SelectQuery, CTEManagement {
     static kind: symbol;
     withClause: WithClause | null;
     selectClause: SelectClause;
@@ -21,6 +21,7 @@ export declare class SimpleSelectQuery extends SqlComponent implements SelectQue
     offsetClause: OffsetClause | null;
     fetchClause: FetchClause | null;
     forClause: ForClause | null;
+    private cteNameCache;
     constructor(params: {
         selectClause: SelectClause;
         fromClause?: FromClause | null;
@@ -35,6 +36,12 @@ export declare class SimpleSelectQuery extends SqlComponent implements SelectQue
         forClause?: ForClause | null;
         withClause?: WithClause | null;
     });
+    /**
+     * Initializes the CTE name cache from existing withClause.
+     * Called during construction and when withClause is modified externally.
+     * @private
+     */
+    private initializeCTECache;
     /**
      * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
      * using UNION as the operator.
@@ -216,4 +223,161 @@ export declare class SimpleSelectQuery extends SqlComponent implements SelectQue
      * @param value Value to set
      */
     setParameter(name: string, value: any): this;
+    /**
+     * Returns this SimpleSelectQuery instance (identity function).
+     * @returns This SimpleSelectQuery instance
+     */
+    toSimpleQuery(): SimpleSelectQuery;
+    /**
+     * Adds a CTE (Common Table Expression) to the query.
+     *
+     * @param name CTE name/alias (must be non-empty)
+     * @param query SelectQuery to use as CTE
+     * @param options Optional configuration
+     * @param options.materialized PostgreSQL-specific: true = MATERIALIZED, false = NOT MATERIALIZED, null/undefined = no hint
+     *
+     * @throws {InvalidCTENameError} When name is empty or whitespace-only
+     * @throws {DuplicateCTEError} When CTE with same name already exists
+     *
+     * @example
+     * ```typescript
+     * // Basic CTE
+     * query.addCTE('active_users',
+     *   SelectQueryParser.parse('SELECT * FROM users WHERE active = true')
+     * );
+     *
+     * // PostgreSQL MATERIALIZED CTE (forces materialization)
+     * query.addCTE('expensive_calc', expensiveQuery, { materialized: true });
+     *
+     * // PostgreSQL NOT MATERIALIZED CTE (prevents materialization)
+     * query.addCTE('simple_view', simpleQuery, { materialized: false });
+     * ```
+     *
+     * @remarks
+     * - MATERIALIZED/NOT MATERIALIZED is PostgreSQL-specific syntax
+     * - Other databases will ignore the materialized hint
+     * - CTE names must be unique within the query
+     * - Method supports fluent chaining
+     */
+    addCTE(name: string, query: SelectQuery, options?: CTEOptions): this;
+    /**
+     * Removes a CTE by name from the query.
+     *
+     * @param name CTE name to remove
+     *
+     * @throws {CTENotFoundError} When CTE with specified name doesn't exist
+     *
+     * @example
+     * ```typescript
+     * query.addCTE('temp_data', tempQuery);
+     * query.removeCTE('temp_data'); // Removes the CTE
+     *
+     * // Throws CTENotFoundError
+     * query.removeCTE('non_existent');
+     * ```
+     *
+     * @remarks
+     * - Throws error if CTE doesn't exist (strict mode for safety)
+     * - Use hasCTE() to check existence before removal if needed
+     * - Method supports fluent chaining
+     */
+    removeCTE(name: string): this;
+    /**
+     * Checks if a CTE with the given name exists in the query.
+     * Optimized with O(1) lookup using internal cache.
+     *
+     * @param name CTE name to check
+     * @returns true if CTE exists, false otherwise
+     *
+     * @example
+     * ```typescript
+     * query.addCTE('user_stats', statsQuery);
+     *
+     * if (query.hasCTE('user_stats')) {
+     *   console.log('CTE exists');
+     * }
+     *
+     * query.removeCTE('user_stats');
+     * console.log(query.hasCTE('user_stats')); // false
+     * ```
+     *
+     * @remarks
+     * - Performs case-sensitive name matching
+     * - Returns false for queries without any CTEs
+     * - Useful for conditional CTE operations
+     * - O(1) performance using internal cache
+     */
+    hasCTE(name: string): boolean;
+    /**
+     * Returns an array of all CTE names in the query.
+     *
+     * @returns Array of CTE names in the order they were defined
+     *
+     * @example
+     * ```typescript
+     * const query = SelectQueryParser.parse('SELECT * FROM data').toSimpleQuery();
+     *
+     * // Empty query
+     * console.log(query.getCTENames()); // []
+     *
+     * // Add CTEs
+     * query.addCTE('users', userQuery);
+     * query.addCTE('orders', orderQuery);
+     *
+     * console.log(query.getCTENames()); // ['users', 'orders']
+     *
+     * // Use for validation
+     * const expectedCTEs = ['users', 'orders', 'products'];
+     * const actualCTEs = query.getCTENames();
+     * const missingCTEs = expectedCTEs.filter(name => !actualCTEs.includes(name));
+     * ```
+     *
+     * @remarks
+     * - Returns empty array for queries without CTEs
+     * - Names are returned in definition order
+     * - Useful for debugging and validation
+     * - Names reflect actual CTE aliases, not table references
+     * - Performance: O(n) but avoids redundant array mapping
+     */
+    getCTENames(): string[];
+    /**
+     * Replaces an existing CTE or adds a new one with the given name.
+     *
+     * @param name CTE name to replace/add (must be non-empty)
+     * @param query SelectQuery to use as CTE
+     * @param options Optional configuration
+     * @param options.materialized PostgreSQL-specific: true = MATERIALIZED, false = NOT MATERIALIZED, null/undefined = no hint
+     *
+     * @throws {InvalidCTENameError} When name is empty or whitespace-only
+     *
+     * @example
+     * ```typescript
+     * const query = SelectQueryParser.parse('SELECT * FROM final_data').toSimpleQuery();
+     * const oldQuery = SelectQueryParser.parse('SELECT id FROM old_table');
+     * const newQuery = SelectQueryParser.parse('SELECT id, status FROM new_table WHERE active = true');
+     *
+     * // Add initial CTE
+     * query.addCTE('data_source', oldQuery);
+     *
+     * // Replace with improved version
+     * query.replaceCTE('data_source', newQuery, { materialized: true });
+     *
+     * // Safe replacement - adds if doesn't exist
+     * query.replaceCTE('new_cte', newQuery); // Won't throw error
+     *
+     * // Chaining replacements
+     * query
+     *   .replaceCTE('cte1', query1, { materialized: false })
+     *   .replaceCTE('cte2', query2, { materialized: true });
+     * ```
+     *
+     * @remarks
+     * - Unlike addCTE(), this method won't throw error if CTE already exists
+     * - Unlike removeCTE(), this method won't throw error if CTE doesn't exist
+     * - Useful for upsert-style CTE operations
+     * - MATERIALIZED/NOT MATERIALIZED is PostgreSQL-specific
+     * - Method supports fluent chaining
+     * - Maintains CTE order when replacing existing CTEs
+     */
+    replaceCTE(name: string, query: SelectQuery, options?: CTEOptions): this;
 }

package/dist/src/models/SimpleSelectQuery.js

@@ -8,6 +8,7 @@ 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 CTEError_1 = require("./CTEError");
 const SelectQueryParser_1 = require("../parsers/SelectQueryParser");
 const Formatter_1 = require("../transformers/Formatter");
 const UpstreamSelectQueryFinder_1 = require("../transformers/UpstreamSelectQueryFinder");
@@ -20,6 +21,8 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
     constructor(params) {
         var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
         super();
+        // Performance optimization: O(1) CTE name lookups
+        this.cteNameCache = new Set();
         this.withClause = (_a = params.withClause) !== null && _a !== void 0 ? _a : null;
         this.selectClause = params.selectClause;
         this.fromClause = (_b = params.fromClause) !== null && _b !== void 0 ? _b : null;
@@ -32,6 +35,22 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
         this.offsetClause = (_j = params.offsetClause) !== null && _j !== void 0 ? _j : null;
         this.fetchClause = (_k = params.fetchClause) !== null && _k !== void 0 ? _k : null;
         this.forClause = (_l = params.forClause) !== null && _l !== void 0 ? _l : null;
+        // Initialize CTE name cache from existing withClause
+        this.initializeCTECache();
+    }
+    /**
+     * Initializes the CTE name cache from existing withClause.
+     * Called during construction and when withClause is modified externally.
+     * @private
+     */
+    initializeCTECache() {
+        var _a;
+        this.cteNameCache.clear();
+        if ((_a = this.withClause) === null || _a === void 0 ? void 0 : _a.tables) {
+            for (const table of this.withClause.tables) {
+                this.cteNameCache.add(table.aliasExpression.table.name);
+            }
+        }
     }
     /**
      * Creates a new BinarySelectQuery with this query as the left side and the provided query as the right side,
@@ -368,6 +387,216 @@ class SimpleSelectQuery extends SqlComponent_1.SqlComponent {
         ParameterHelper_1.ParameterHelper.set(this, name, value);
         return this;
     }
+    /**
+     * Returns this SimpleSelectQuery instance (identity function).
+     * @returns This SimpleSelectQuery instance
+     */
+    toSimpleQuery() {
+        return this;
+    }
+    /**
+     * Adds a CTE (Common Table Expression) to the query.
+     *
+     * @param name CTE name/alias (must be non-empty)
+     * @param query SelectQuery to use as CTE
+     * @param options Optional configuration
+     * @param options.materialized PostgreSQL-specific: true = MATERIALIZED, false = NOT MATERIALIZED, null/undefined = no hint
+     *
+     * @throws {InvalidCTENameError} When name is empty or whitespace-only
+     * @throws {DuplicateCTEError} When CTE with same name already exists
+     *
+     * @example
+     * ```typescript
+     * // Basic CTE
+     * query.addCTE('active_users',
+     *   SelectQueryParser.parse('SELECT * FROM users WHERE active = true')
+     * );
+     *
+     * // PostgreSQL MATERIALIZED CTE (forces materialization)
+     * query.addCTE('expensive_calc', expensiveQuery, { materialized: true });
+     *
+     * // PostgreSQL NOT MATERIALIZED CTE (prevents materialization)
+     * query.addCTE('simple_view', simpleQuery, { materialized: false });
+     * ```
+     *
+     * @remarks
+     * - MATERIALIZED/NOT MATERIALIZED is PostgreSQL-specific syntax
+     * - Other databases will ignore the materialized hint
+     * - CTE names must be unique within the query
+     * - Method supports fluent chaining
+     */
+    addCTE(name, query, options) {
+        var _a;
+        // Validate CTE name
+        if (!name || name.trim() === '') {
+            throw new CTEError_1.InvalidCTENameError(name, 'name cannot be empty or whitespace-only');
+        }
+        // Check for duplicate CTE name
+        if (this.hasCTE(name)) {
+            throw new CTEError_1.DuplicateCTEError(name);
+        }
+        const materialized = (_a = options === null || options === void 0 ? void 0 : options.materialized) !== null && _a !== void 0 ? _a : null;
+        const commonTable = new Clause_1.CommonTable(query, name, materialized);
+        this.appendWith(commonTable);
+        // Update cache for O(1) future lookups
+        this.cteNameCache.add(name);
+        return this;
+    }
+    /**
+     * Removes a CTE by name from the query.
+     *
+     * @param name CTE name to remove
+     *
+     * @throws {CTENotFoundError} When CTE with specified name doesn't exist
+     *
+     * @example
+     * ```typescript
+     * query.addCTE('temp_data', tempQuery);
+     * query.removeCTE('temp_data'); // Removes the CTE
+     *
+     * // Throws CTENotFoundError
+     * query.removeCTE('non_existent');
+     * ```
+     *
+     * @remarks
+     * - Throws error if CTE doesn't exist (strict mode for safety)
+     * - Use hasCTE() to check existence before removal if needed
+     * - Method supports fluent chaining
+     */
+    removeCTE(name) {
+        if (!this.hasCTE(name)) {
+            throw new CTEError_1.CTENotFoundError(name);
+        }
+        if (this.withClause) {
+            this.withClause.tables = this.withClause.tables.filter(table => table.aliasExpression.table.name !== name);
+            if (this.withClause.tables.length === 0) {
+                this.withClause = null;
+            }
+        }
+        // Update cache for O(1) future lookups
+        this.cteNameCache.delete(name);
+        return this;
+    }
+    /**
+     * Checks if a CTE with the given name exists in the query.
+     * Optimized with O(1) lookup using internal cache.
+     *
+     * @param name CTE name to check
+     * @returns true if CTE exists, false otherwise
+     *
+     * @example
+     * ```typescript
+     * query.addCTE('user_stats', statsQuery);
+     *
+     * if (query.hasCTE('user_stats')) {
+     *   console.log('CTE exists');
+     * }
+     *
+     * query.removeCTE('user_stats');
+     * console.log(query.hasCTE('user_stats')); // false
+     * ```
+     *
+     * @remarks
+     * - Performs case-sensitive name matching
+     * - Returns false for queries without any CTEs
+     * - Useful for conditional CTE operations
+     * - O(1) performance using internal cache
+     */
+    hasCTE(name) {
+        return this.cteNameCache.has(name);
+    }
+    /**
+     * Returns an array of all CTE names in the query.
+     *
+     * @returns Array of CTE names in the order they were defined
+     *
+     * @example
+     * ```typescript
+     * const query = SelectQueryParser.parse('SELECT * FROM data').toSimpleQuery();
+     *
+     * // Empty query
+     * console.log(query.getCTENames()); // []
+     *
+     * // Add CTEs
+     * query.addCTE('users', userQuery);
+     * query.addCTE('orders', orderQuery);
+     *
+     * console.log(query.getCTENames()); // ['users', 'orders']
+     *
+     * // Use for validation
+     * const expectedCTEs = ['users', 'orders', 'products'];
+     * const actualCTEs = query.getCTENames();
+     * const missingCTEs = expectedCTEs.filter(name => !actualCTEs.includes(name));
+     * ```
+     *
+     * @remarks
+     * - Returns empty array for queries without CTEs
+     * - Names are returned in definition order
+     * - Useful for debugging and validation
+     * - Names reflect actual CTE aliases, not table references
+     * - Performance: O(n) but avoids redundant array mapping
+     */
+    getCTENames() {
+        var _a, _b;
+        return (_b = (_a = this.withClause) === null || _a === void 0 ? void 0 : _a.tables.map(table => table.aliasExpression.table.name)) !== null && _b !== void 0 ? _b : [];
+    }
+    /**
+     * Replaces an existing CTE or adds a new one with the given name.
+     *
+     * @param name CTE name to replace/add (must be non-empty)
+     * @param query SelectQuery to use as CTE
+     * @param options Optional configuration
+     * @param options.materialized PostgreSQL-specific: true = MATERIALIZED, false = NOT MATERIALIZED, null/undefined = no hint
+     *
+     * @throws {InvalidCTENameError} When name is empty or whitespace-only
+     *
+     * @example
+     * ```typescript
+     * const query = SelectQueryParser.parse('SELECT * FROM final_data').toSimpleQuery();
+     * const oldQuery = SelectQueryParser.parse('SELECT id FROM old_table');
+     * const newQuery = SelectQueryParser.parse('SELECT id, status FROM new_table WHERE active = true');
+     *
+     * // Add initial CTE
+     * query.addCTE('data_source', oldQuery);
+     *
+     * // Replace with improved version
+     * query.replaceCTE('data_source', newQuery, { materialized: true });
+     *
+     * // Safe replacement - adds if doesn't exist
+     * query.replaceCTE('new_cte', newQuery); // Won't throw error
+     *
+     * // Chaining replacements
+     * query
+     *   .replaceCTE('cte1', query1, { materialized: false })
+     *   .replaceCTE('cte2', query2, { materialized: true });
+     * ```
+     *
+     * @remarks
+     * - Unlike addCTE(), this method won't throw error if CTE already exists
+     * - Unlike removeCTE(), this method won't throw error if CTE doesn't exist
+     * - Useful for upsert-style CTE operations
+     * - MATERIALIZED/NOT MATERIALIZED is PostgreSQL-specific
+     * - Method supports fluent chaining
+     * - Maintains CTE order when replacing existing CTEs
+     */
+    replaceCTE(name, query, options) {
+        var _a;
+        // Validate CTE name
+        if (!name || name.trim() === '') {
+            throw new CTEError_1.InvalidCTENameError(name, 'name cannot be empty or whitespace-only');
+        }
+        // Remove existing CTE if it exists (don't throw error if not found)
+        if (this.hasCTE(name)) {
+            this.removeCTE(name);
+        }
+        // Add new CTE (but skip duplicate check since we just removed it)
+        const materialized = (_a = options === null || options === void 0 ? void 0 : options.materialized) !== null && _a !== void 0 ? _a : null;
+        const commonTable = new Clause_1.CommonTable(query, name, materialized);
+        this.appendWith(commonTable);
+        // Update cache for O(1) future lookups
+        this.cteNameCache.add(name);
+        return this;
+    }
 }
 exports.SimpleSelectQuery = SimpleSelectQuery;
 SimpleSelectQuery.kind = Symbol("SelectQuery");