rawsql-ts 0.11.19-beta → 0.11.21-beta

package/dist/src/index.d.ts

@@ -1,5 +1,6 @@
 export * from './parsers/SelectQueryParser';
 export * from './parsers/InsertQueryParser';
+export * from './parsers/WithClauseParser';
 export * from './models/BinarySelectQuery';
 export * from './models/SelectQuery';
 export * from './models/ValueComponent';
@@ -20,6 +21,7 @@ export * from './transformers/PostgresJsonQueryBuilder';
 export * from './transformers/QueryBuilder';
 export * from './transformers/SelectValueCollector';
 export * from './transformers/SelectableColumnCollector';
+export { DuplicateDetectionMode } from './transformers/SelectableColumnCollector';
 export * from './transformers/TableColumnResolver';
 export * from './transformers/TableSourceCollector';
 export * from './transformers/JsonMappingConverter';

package/dist/src/index.js

@@ -14,10 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.unifyJsonMapping = exports.isLegacyFormat = exports.isUnifiedFormat = exports.isModelDrivenFormat = exports.processJsonMapping = exports.validateModelDrivenMapping = exports.convertModelDrivenMapping = void 0;
+exports.unifyJsonMapping = exports.isLegacyFormat = exports.isUnifiedFormat = exports.isModelDrivenFormat = exports.processJsonMapping = exports.validateModelDrivenMapping = exports.convertModelDrivenMapping = exports.DuplicateDetectionMode = void 0;
 // Entry point for rawsql-ts package
 __exportStar(require("./parsers/SelectQueryParser"), exports);
 __exportStar(require("./parsers/InsertQueryParser"), exports);
+__exportStar(require("./parsers/WithClauseParser"), exports);
 __exportStar(require("./models/BinarySelectQuery"), exports);
 __exportStar(require("./models/SelectQuery"), exports);
 __exportStar(require("./models/ValueComponent"), exports);
@@ -38,6 +39,8 @@ __exportStar(require("./transformers/PostgresJsonQueryBuilder"), exports);
 __exportStar(require("./transformers/QueryBuilder"), exports); // old name:QueryConverter
 __exportStar(require("./transformers/SelectValueCollector"), exports);
 __exportStar(require("./transformers/SelectableColumnCollector"), exports);
+var SelectableColumnCollector_1 = require("./transformers/SelectableColumnCollector");
+Object.defineProperty(exports, "DuplicateDetectionMode", { enumerable: true, get: function () { return SelectableColumnCollector_1.DuplicateDetectionMode; } });
 __exportStar(require("./transformers/TableColumnResolver"), exports);
 __exportStar(require("./transformers/TableSourceCollector"), exports);
 __exportStar(require("./transformers/JsonMappingConverter"), 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;AACrC,oDAAkC;AAClC,kDAAgC;AAEhC,8DAA4C;AAC5C,+DAA6C;AAC7C,6DAA2C;AAC3C,uEAAqD;AACrD,oEAAkD;AAClD,6DAA2C;AAC3C,4DAA0C;AAC1C,0EAAwD;AACxD,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,2EAAyD;AACzD,kEAAgD;AAChD,iEAA+C;AAC/C,uEAAqD;AACrD,qEAAmD;AAEnD,6DAA2C;AAC3C,8DAA4C;AAC5C,wDAAsC;AACtC,wDAAsC;AACtC,uDAAqC;AAGrC,oEAAoE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,8DAA4C;AAC5C,8DAA4C;AAC5C,6DAA2C;AAE3C,6DAA2C;AAC3C,uDAAqC;AACrC,0DAAwC;AACxC,uDAAqC;AACrC,oDAAkC;AAClC,kDAAgC;AAEhC,8DAA4C;AAC5C,+DAA6C;AAC7C,6DAA2C;AAC3C,uEAAqD;AACrD,oEAAkD;AAClD,6DAA2C;AAC3C,4DAA0C;AAC1C,0EAAwD;AACxD,2DAAyC;AACzC,8DAA4C;AAC5C,0EAAwD;AACxD,8DAA4C,CAAC,0BAA0B;AACvE,sEAAoD;AACpD,2EAAyD;AACzD,sFAAkF;AAAzE,mIAAA,sBAAsB,OAAA;AAC/B,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,2EAAyD;AACzD,kEAAgD;AAChD,iEAA+C;AAC/C,uEAAqD;AACrD,qEAAmD;AAEnD,6DAA2C;AAC3C,8DAA4C;AAC5C,wDAAsC;AACtC,wDAAsC;AACtC,uDAAqC;AAGrC,oEAAoE"}

package/dist/src/parsers/WithClauseParser.d.ts

@@ -1,7 +1,58 @@
 import { WithClause } from "../models/Clause";
 import { Lexeme } from "../models/Lexeme";
+/**
+ * Parser for SQL WITH clauses (Common Table Expressions - CTEs).
+ * Parses only the WITH clause portion of SQL, not the entire query.
+ *
+ * **Note**: For most use cases, use `SelectQueryParser` which provides more comprehensive SQL parsing.
+ * This parser should only be used for the special case where you need to analyze only the WITH clause portion.
+ *
+ * @example
+ * ```typescript
+ * // Parses only the WITH clause, not the following SELECT
+ * const sql = "WITH recursive_cte AS (SELECT 1 as n UNION SELECT n+1 FROM recursive_cte WHERE n < 10)";
+ * const withClause = WithClauseParser.parse(sql);
+ * console.log(withClause.recursive); // true
+ * console.log(withClause.tables.length); // 1
+ * ```
+ */
 export declare class WithClauseParser {
+    /**
+     * Parses a SQL string containing only a WITH clause into a WithClause AST.
+     * The input should contain only the WITH clause, not the subsequent main query.
+     *
+     * @param query - The SQL string containing only the WITH clause
+     * @returns The parsed WithClause object
+     * @throws Error if the syntax is invalid or there are unexpected tokens after the WITH clause
+     *
+     * @example
+     * ```typescript
+     * // Correct: Only the WITH clause
+     * const sql = "WITH users_data AS (SELECT id, name FROM users)";
+     * const withClause = WithClauseParser.parse(sql);
+     *
+     * // Error: Contains SELECT after WITH clause
+     * // const badSql = "WITH users_data AS (SELECT id, name FROM users) SELECT * FROM users_data";
+     * ```
+     */
     static parse(query: string): WithClause;
+    /**
+     * Parses a WITH clause from an array of lexemes starting at the specified index.
+     *
+     * @param lexemes - Array of lexemes to parse from
+     * @param index - Starting index in the lexemes array
+     * @returns Object containing the parsed WithClause and the new index position
+     * @throws Error if the syntax is invalid or WITH keyword is not found
+     *
+     * @example
+     * ```typescript
+     * const tokenizer = new SqlTokenizer("WITH cte AS (SELECT 1)");
+     * const lexemes = tokenizer.readLexmes();
+     * const result = WithClauseParser.parseFromLexeme(lexemes, 0);
+     * console.log(result.value.tables.length); // 1
+     * console.log(result.newIndex); // position after the WITH clause
+     * ```
+     */
     static parseFromLexeme(lexemes: Lexeme[], index: number): {
         value: WithClause;
         newIndex: number;

package/dist/src/parsers/WithClauseParser.js

@@ -5,8 +5,41 @@ const Clause_1 = require("../models/Clause");
 const Lexeme_1 = require("../models/Lexeme");
 const SqlTokenizer_1 = require("./SqlTokenizer");
 const CommonTableParser_1 = require("./CommonTableParser");
+/**
+ * Parser for SQL WITH clauses (Common Table Expressions - CTEs).
+ * Parses only the WITH clause portion of SQL, not the entire query.
+ *
+ * **Note**: For most use cases, use `SelectQueryParser` which provides more comprehensive SQL parsing.
+ * This parser should only be used for the special case where you need to analyze only the WITH clause portion.
+ *
+ * @example
+ * ```typescript
+ * // Parses only the WITH clause, not the following SELECT
+ * const sql = "WITH recursive_cte AS (SELECT 1 as n UNION SELECT n+1 FROM recursive_cte WHERE n < 10)";
+ * const withClause = WithClauseParser.parse(sql);
+ * console.log(withClause.recursive); // true
+ * console.log(withClause.tables.length); // 1
+ * ```
+ */
 class WithClauseParser {
-    // Parse SQL string to AST (was: parse)
+    /**
+     * Parses a SQL string containing only a WITH clause into a WithClause AST.
+     * The input should contain only the WITH clause, not the subsequent main query.
+     *
+     * @param query - The SQL string containing only the WITH clause
+     * @returns The parsed WithClause object
+     * @throws Error if the syntax is invalid or there are unexpected tokens after the WITH clause
+     *
+     * @example
+     * ```typescript
+     * // Correct: Only the WITH clause
+     * const sql = "WITH users_data AS (SELECT id, name FROM users)";
+     * const withClause = WithClauseParser.parse(sql);
+     *
+     * // Error: Contains SELECT after WITH clause
+     * // const badSql = "WITH users_data AS (SELECT id, name FROM users) SELECT * FROM users_data";
+     * ```
+     */
     static parse(query) {
         const tokenizer = new SqlTokenizer_1.SqlTokenizer(query); // Initialize tokenizer
         const lexemes = tokenizer.readLexmes(); // Get tokens
@@ -18,7 +51,23 @@ class WithClauseParser {
         }
         return result.value;
     }
-    // Parse from lexeme array (was: parse)
+    /**
+     * Parses a WITH clause from an array of lexemes starting at the specified index.
+     *
+     * @param lexemes - Array of lexemes to parse from
+     * @param index - Starting index in the lexemes array
+     * @returns Object containing the parsed WithClause and the new index position
+     * @throws Error if the syntax is invalid or WITH keyword is not found
+     *
+     * @example
+     * ```typescript
+     * const tokenizer = new SqlTokenizer("WITH cte AS (SELECT 1)");
+     * const lexemes = tokenizer.readLexmes();
+     * const result = WithClauseParser.parseFromLexeme(lexemes, 0);
+     * console.log(result.value.tables.length); // 1
+     * console.log(result.newIndex); // position after the WITH clause
+     * ```
+     */
     static parseFromLexeme(lexemes, index) {
         let idx = index;
         // Capture comments from the WITH keyword

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

@@ -1 +1 @@
-{"version":3,"file":"WithClauseParser.js","sourceRoot":"","sources":["../../../src/parsers/WithClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAA2D;AAC3D,6CAAqD;AACrD,iDAA8C;AAC9C,2DAAwD;AAExD,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,yCAAyC;QACzC,MAAM,iBAAiB,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QAE9E,sBAAsB;QACtB,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACtE,GAAG,EAAE,CAAC;QACV,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,0BAA0B,CAAC,CAAC;QAC/E,CAAC;QAED,8BAA8B;QAC9B,MAAM,SAAS,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC;QAC3F,IAAI,SAAS,EAAE,CAAC;YACZ,GAAG,EAAE,CAAC;QACV,CAAC;QAED,aAAa;QACb,MAAM,MAAM,GAAkB,EAAE,CAAC;QAEjC,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,qCAAiB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAExB,mCAAmC;QACnC,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,CAAC,aAAa;YAEpB,wDAAwD;YACxD,yEAAyE;YACzE,MAAM,SAAS,GAAG,qCAAiB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAClE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC7B,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC;QAC7B,CAAC;QAED,mCAAmC;QACnC,MAAM,UAAU,GAAG,IAAI,mBAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACrD,UAAU,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QAExC,OAAO;YACH,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,GAAG;SAChB,CAAC;IACN,CAAC;CACJ;AAjED,4CAiEC"}
+{"version":3,"file":"WithClauseParser.js","sourceRoot":"","sources":["../../../src/parsers/WithClauseParser.ts"],"names":[],"mappings":";;;AAAA,6CAA2D;AAC3D,6CAAqD;AACrD,iDAA8C;AAC9C,2DAAwD;AAExD;;;;;;;;;;;;;;;GAeG;AACH,MAAa,gBAAgB;IACzB;;;;;;;;;;;;;;;;;OAiBG;IACI,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;;;;;;;;;;;;;;;;OAgBG;IACI,MAAM,CAAC,eAAe,CAAC,OAAiB,EAAE,KAAa;QAC1D,IAAI,GAAG,GAAG,KAAK,CAAC;QAEhB,yCAAyC;QACzC,MAAM,iBAAiB,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QAE9E,sBAAsB;QACtB,IAAI,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACtE,GAAG,EAAE,CAAC;QACV,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,0BAA0B,CAAC,CAAC;QAC/E,CAAC;QAED,8BAA8B;QAC9B,MAAM,SAAS,GAAG,GAAG,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,WAAW,CAAC;QAC3F,IAAI,SAAS,EAAE,CAAC;YACZ,GAAG,EAAE,CAAC;QACV,CAAC;QAED,aAAa;QACb,MAAM,MAAM,GAAkB,EAAE,CAAC;QAEjC,6BAA6B;QAC7B,MAAM,QAAQ,GAAG,qCAAiB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC5B,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAExB,mCAAmC;QACnC,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,CAAC,aAAa;YAEpB,wDAAwD;YACxD,yEAAyE;YACzE,MAAM,SAAS,GAAG,qCAAiB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAClE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAC7B,GAAG,GAAG,SAAS,CAAC,QAAQ,CAAC;QAC7B,CAAC;QAED,mCAAmC;QACnC,MAAM,UAAU,GAAG,IAAI,mBAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACrD,UAAU,CAAC,QAAQ,GAAG,iBAAiB,CAAC;QAExC,OAAO;YACH,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,GAAG;SAChB,CAAC;IACN,CAAC;CACJ;AAlGD,4CAkGC"}

package/dist/src/transformers/SelectableColumnCollector.d.ts

@@ -20,28 +20,58 @@ import { SqlComponent, SqlComponentVisitor } from "../models/SqlComponent";
 import { ValueComponent } from "../models/ValueComponent";
 import { TableColumnResolver } from "./TableColumnResolver";
 /**
- * A visitor that collects all ColumnReference instances from SimpleSelectQuery structures.
+ * A visitor that collects all ColumnReference instances from SQL query structures.
  * This visitor scans through all clauses and collects all unique ColumnReference objects.
- * It does not scan Common Table Expressions (CTEs) or subqueries.
+ * It supports both regular column collection and upstream column collection for maximum
+ * search conditions in DynamicQuery scenarios.
  *
- * IMPORTANT: This collector only supports SimpleSelectQuery. BinarySelectQuery
- * (UNION/INTERSECT/EXCEPT) will throw an error and should be decomposed into
- * individual SimpleSelectQuery branches before using this collector.
+ * Supported query types:
+ * - SimpleSelectQuery: Basic SELECT queries with all standard clauses
+ * - BinarySelectQuery: UNION, INTERSECT, EXCEPT queries (collects from both sides)
+ * - Common Table Expressions (CTEs) within queries
+ * - Subqueries and nested queries
  *
  * Behavioral notes:
- * - Only collects column references to tables defined in the root FROM/JOIN clauses
+ * - Collects column references to tables defined in the root FROM/JOIN clauses
  * - For aliased columns (e.g., 'title as name'), collects both the original column
  *   reference ('title') AND the alias ('name') to enable complete dependency tracking
+ * - When upstream option is enabled, collects all available columns from upstream sources
+ *   (CTEs, subqueries, and tables) for maximum search conditions in DynamicQuery
+ * - Automatically removes duplicates based on the specified duplicate detection mode
  *
  * Use cases:
  * - Dependency analysis and schema migration tools
- * - Column usage tracking within individual SELECT branches
+ * - Column usage tracking across complex queries including unions and CTEs
  * - Security analysis for column-level access control
+ * - DynamicQuery maximum search condition column discovery
+ *
+ * @example
+ * ```typescript
+ * // Basic usage - collect only referenced columns
+ * const collector = new SelectableColumnCollector();
+ * const columns = collector.collect(query);
+ *
+ * // With upstream collection for DynamicQuery
+ * const upstreamCollector = new SelectableColumnCollector(
+ *   null, false, DuplicateDetectionMode.ColumnNameOnly,
+ *   { upstream: true }
+ * );
+ * const allColumns = upstreamCollector.collect(query);
+ *
+ * // Works with union queries and CTEs
+ * const unionQuery = SelectQueryParser.parse(`
+ *   SELECT name, email FROM users
+ *   UNION
+ *   SELECT name, email FROM customers
+ * `);
+ * const unionColumns = collector.collect(unionQuery);
+ * ```
  */
 export declare class SelectableColumnCollector implements SqlComponentVisitor<void> {
     private handlers;
     private selectValues;
     private visitedNodes;
+    private uniqueKeys;
     private isRootVisit;
     private tableColumnResolver;
     private commonTableCollector;
@@ -57,10 +87,28 @@ export declare class SelectableColumnCollector implements SqlComponentVisitor<vo
      * @param {DuplicateDetectionMode} [duplicateDetection=DuplicateDetectionMode.ColumnNameOnly] - Specifies the duplicate detection mode: 'columnNameOnly' (default, only column name is used), or 'fullName' (table name + column name).
      * @param {Object} [options={}] - Additional options for the collector.
      * @param {boolean} [options.ignoreCaseAndUnderscore=false] - If true, column names are compared without considering case and underscores.
+     * @param {boolean} [options.upstream=false] - If true, collect all columns available from upstream sources for maximum search conditions in DynamicQuery.
      */
     constructor(tableColumnResolver?: TableColumnResolver | null, includeWildCard?: boolean, duplicateDetection?: DuplicateDetectionMode, options?: {
         ignoreCaseAndUnderscore?: boolean;
+        upstream?: boolean;
     });
+    /**
+     * Initialize instance properties.
+     */
+    private initializeProperties;
+    /**
+     * Initialize the handler map for different SQL component types.
+     */
+    private initializeHandlers;
+    /**
+     * Initialize handlers for SQL clause types.
+     */
+    private initializeClauseHandlers;
+    /**
+     * Initialize handlers for value component types.
+     */
+    private initializeValueComponentHandlers;
     getValues(): {
         name: string;
         value: ValueComponent;
@@ -75,10 +123,18 @@ export declare class SelectableColumnCollector implements SqlComponentVisitor<vo
     private reset;
     /**
      * Add a select value as unique, according to the duplicate detection option.
-     * If duplicateDetection is 'columnNameOnly', only column name is checked.
-     * If duplicateDetection is 'fullName', both table and column name are checked.
+     * Uses efficient Set-based duplicate detection for better performance.
      */
     private addSelectValueAsUnique;
+    /**
+     * Generate a unique key based on the duplicate detection mode.
+     */
+    private generateUniqueKey;
+    /**
+     * Normalize column name based on options.
+     * Ensures safe string handling to prevent injection attacks.
+     */
+    private normalizeColumnName;
     /**
      * Main entry point for the visitor pattern.
      * Implements the shallow visit pattern to distinguish between root and recursive visits.
@@ -93,6 +149,10 @@ export declare class SelectableColumnCollector implements SqlComponentVisitor<vo
       * Process a SimpleSelectQuery to collect ColumnReferences from all its clauses
       */
     private visitSimpleSelectQuery;
+    /**
+     * Process a BinarySelectQuery (UNION, INTERSECT, EXCEPT) to collect ColumnReferences from both sides
+     */
+    private visitBinarySelectQuery;
     private visitSelectClause;
     private visitFromClause;
     private visitWhereClause;
@@ -118,4 +178,29 @@ export declare class SelectableColumnCollector implements SqlComponentVisitor<vo
     private visitArrayQueryExpression;
     private visitValueList;
     private visitPartitionByClause;
+    /**
+     * Collect all upstream columns available for DynamicQuery maximum search conditions.
+     * This includes columns from CTEs, subqueries, and tables that can be used for filtering.
+     */
+    private collectUpstreamColumns;
+    /**
+     * Collect upstream columns from a specific source (table, subquery, or CTE).
+     */
+    private collectUpstreamColumnsFromSource;
+    /**
+     * Collect upstream columns from a table source using table column resolver.
+     */
+    private collectUpstreamColumnsFromTable;
+    /**
+     * Collect upstream columns from a subquery source.
+     */
+    private collectUpstreamColumnsFromSubquery;
+    /**
+     * Collect upstream columns from a CTE.
+     */
+    private collectUpstreamColumnsFromCTE;
+    /**
+     * Find a CTE by name in the common tables.
+     */
+    private findCTEByName;
 }