rawsql-ts 0.14.4 → 0.15.0

package/README.md

@@ -584,9 +584,13 @@ const isValid = builder.validateSql('SELECT id FROM users');
 console.log(isValid); // true
 ```
 
-For more details, see the [DynamicQueryBuilder Usage Guide](../../docs/usage-guides/class-DynamicQueryBuilder-usage-guide.md).
-
----
+For more details, see the [DynamicQueryBuilder Usage Guide](../../docs/guide/querybuilding-recipes.md).
+
+---
+
+### Correlated EXISTS filtering
+
+`DynamicQueryBuilder` can append correlated `EXISTS`/`NOT EXISTS` predicates directly from filter metadata. Attach an `exists` or `notExists` object to a column entry, or use `$exists`/`$notExists` arrays when you need multiple anchors. Inside each subquery use `$c0`, `$c1`, … placeholders that correspond to the anchor columns, and pass `params` to bind any additional named parameters. Enable `existsStrict: true` in `QueryBuildOptions` to throw when placeholder numbering or anchor resolution fails instead of silently skipping the predicate.
 
 ## Query Flow Diagram Generation
 

package/dist/index.js

@@ -14,7 +14,7 @@ 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.getCompletionSuggestions = exports.getIntelliSenseInfo = exports.splitQueries = exports.resolveScope = exports.getCursorContext = exports.parseToPosition = exports.tableNameVariants = exports.normalizeTableName = exports.FilterableItem = exports.TableSchema = exports.unifyJsonMapping = exports.isLegacyFormat = exports.isUnifiedFormat = exports.isModelDrivenFormat = exports.processJsonMapping = exports.validateModelDrivenMapping = exports.convertModelDrivenMapping = exports.FixtureCteBuilder = exports.DuplicateDetectionMode = void 0;
+exports.getCompletionSuggestions = exports.getIntelliSenseInfo = exports.splitQueries = exports.resolveScope = exports.getCursorContext = exports.parseToPosition = exports.tableNameVariants = exports.normalizeTableName = exports.FilterableItem = exports.TableSchema = exports.unifyJsonMapping = exports.isLegacyFormat = exports.isUnifiedFormat = exports.isModelDrivenFormat = exports.processJsonMapping = exports.validateModelDrivenMapping = exports.convertModelDrivenMapping = exports.optimizeUnusedCtesToFixedPoint = exports.optimizeUnusedCtes = exports.optimizeUnusedLeftJoinsToFixedPoint = exports.optimizeUnusedLeftJoins = exports.FixtureCteBuilder = exports.DuplicateDetectionMode = void 0;
 // Entry point for rawsql-ts package
 __exportStar(require("./parsers/SqlParser"), exports);
 __exportStar(require("./parsers/SelectQueryParser"), exports);
@@ -85,6 +85,11 @@ __exportStar(require("./transformers/FilterableItemCollector"), exports);
 var FixtureCteBuilder_1 = require("./transformers/FixtureCteBuilder");
 Object.defineProperty(exports, "FixtureCteBuilder", { enumerable: true, get: function () { return FixtureCteBuilder_1.FixtureCteBuilder; } });
 __exportStar(require("./transformers/DynamicQueryBuilder"), exports);
+var OptimizeUnusedLeftJoins_1 = require("./transformers/OptimizeUnusedLeftJoins");
+Object.defineProperty(exports, "optimizeUnusedLeftJoins", { enumerable: true, get: function () { return OptimizeUnusedLeftJoins_1.optimizeUnusedLeftJoins; } });
+Object.defineProperty(exports, "optimizeUnusedLeftJoinsToFixedPoint", { enumerable: true, get: function () { return OptimizeUnusedLeftJoins_1.optimizeUnusedLeftJoinsToFixedPoint; } });
+Object.defineProperty(exports, "optimizeUnusedCtes", { enumerable: true, get: function () { return OptimizeUnusedLeftJoins_1.optimizeUnusedCtes; } });
+Object.defineProperty(exports, "optimizeUnusedCtesToFixedPoint", { enumerable: true, get: function () { return OptimizeUnusedLeftJoins_1.optimizeUnusedCtesToFixedPoint; } });
 __exportStar(require("./transformers/TableColumnResolver"), exports);
 __exportStar(require("./transformers/TableSourceCollector"), exports);
 __exportStar(require("./transformers/JsonMappingConverter"), exports);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,sDAAoC;AACpC,8DAA4C;AAE5C,8DAA4C;AAC5C,8DAA4C;AAC5C,8DAA4C;AAC5C,6DAA2C;AAC3C,8DAA4C;AAC5C,6DAA2C;AAC3C,8DAA4C;AAC5C,4DAA0C;AAC1C,4DAA0C;AAC1C,6DAA2C;AAC3C,iEAA+C;AAC/C,kEAAgD;AAChD,mEAAiD;AACjD,mEAAiD;AACjD,sEAAoD;AAEpD,qDAAmC;AAEnC,6DAA2C;AAC3C,uDAAqC;AACrC,wDAAsC;AACtC,0DAAwC;AACxC,uDAAqC;AACrC,kDAAgC;AAChC,oDAAkC;AAClC,kDAAgC;AAChC,4DAA0C;AAC1C,uDAAqC;AACrC,uDAAqC;AACrC,uDAAqC;AACrC,4DAA0C;AAC1C,sDAAoC;AACpC,yDAAuC;AACvC,gEAA8C;AAE9C,8DAA4C;AAC5C,+DAA6C;AAC7C,6DAA2C;AAC3C,uEAAqD;AACrD,4EAA0D;AAC1D,oEAAkD;AAElD,6DAA2C;AAC3C,4DAA0C;AAC1C,8DAA4C;AAC5C,8DAA4C;AAC5C,sEAAoD;AACpD,sEAAoD;AAEpD,0EAAwD;AACxD,2DAAyC;AACzC,8DAA4C;AAC5C,0EAAwD;AACxD,8DAA4C,CAAC,0BAA0B;AACvE,kFAAgE;AAChE,6EAA2D;AAE3D,6EAA2D;AAC3D,6EAA2D;AAC3D,4EAA0D;AAC1D,6EAA2D;AAC3D,0EAAwD;AACxD,uEAAqD;AACrD,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,2EAAyD;AACzD,sFAAkF;AAAzE,mIAAA,sBAAsB,OAAA;AAC/B,yEAAuD;AACvD,sEAAsH;AAA7G,sHAAA,iBAAiB,OAAA;AAC1B,qEAAmD;AACnD,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,kEAAmF;AAA1E,8GAAA,WAAW,OAAA;AACpB,yEAAuD;AACvD,kFAAwG;AAA/F,yHAAA,cAAc,OAAA;AACvB,2EAAyD;AACzD,kEAAgD;AAChD,iEAA+C;AAC/C,uEAAqD;AACrD,qEAAmD;AAEnD,6DAA2C;AAC3C,8DAA4C;AAC5C,wDAAsC;AACtC,wDAAsC;AACtC,uDAAqC;AAErC,4DAA0C;AAG1C,kDAAkD;AAClD,gEAA8C;AAE9C,wDAAsC;AAOtC,8DAA4C;AAK5C,6DAA2C;AAG3C,yDAA+E;AAAtE,oHAAA,kBAAkB,OAAA;AAAE,mHAAA,iBAAiB,OAAA;AAE9C,8CAA8C;AAC9C,yDAAuC;AAEvC,qDAAqD;AACrD,2DAaiC;AAZ7B,0DAA0D;AAC1D,kHAAA,eAAe,OAAA;AACf,8CAA8C;AAC9C,mHAAA,gBAAgB,OAAA;AAChB,mDAAmD;AACnD,+GAAA,YAAY,OAAA;AACZ,yDAAyD;AACzD,+GAAA,YAAY,OAAA;AACZ,2DAA2D;AAC3D,sHAAA,mBAAmB,OAAA;AACnB,yDAAyD;AACzD,2HAAA,wBAAwB,OAAA;AAI5B,oEAAoE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/src/index.d.ts

@@ -69,6 +69,7 @@ export { DuplicateDetectionMode } from './transformers/SelectableColumnCollector
 export * from './transformers/FilterableItemCollector';
 export { FixtureCteBuilder, FixtureTableDefinition, FixtureColumnDefinition } from './transformers/FixtureCteBuilder';
 export * from './transformers/DynamicQueryBuilder';
+export { SchemaInfo, optimizeUnusedLeftJoins, optimizeUnusedLeftJoinsToFixedPoint, optimizeUnusedCtes, optimizeUnusedCtesToFixedPoint } from './transformers/OptimizeUnusedLeftJoins';
 export * from './transformers/TableColumnResolver';
 export * from './transformers/TableSourceCollector';
 export * from './transformers/JsonMappingConverter';

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

@@ -3,18 +3,22 @@ import { SortConditions } from "./SqlSortInjector";
 import { PaginationOptions } from "./SqlPaginationInjector";
 import { JsonMapping } from "./PostgresJsonQueryBuilder";
 import { SqlParameterValue } from "../models/ValueComponent";
+import { type ExistsSubqueryDefinition } from "./ExistsPredicateInjector";
+import { SchemaInfo } from "./OptimizeUnusedLeftJoins";
+export type { ExistsSubqueryDefinition };
 /**
- * Value union accepted for a single filter entry in DynamicQueryBuilder.
+ * Object-form filter condition supporting scalar operators, logical grouping,
+ * and column-anchored EXISTS/NOT EXISTS predicates.
  *
  * @example
- * ```typescript
- * const options = { filter: { price: { min: 10, max: 100 }, status: ['active', 'pending'] } };
- * builder.buildQuery('SELECT * FROM orders', options);
- * ```
+ * const filter: FilterConditionObject = {
+ *   min: 10,
+ *   max: 100,
+ *   exists: { sql: 'SELECT 1 FROM orders WHERE user_id = $c0' }
+ * };
  * Related tests: packages/core/tests/transformers/DynamicQueryBuilder.test.ts
-
  */
-export type FilterConditionValue = SqlParameterValue | SqlParameterValue[] | {
+export interface FilterConditionObject {
     min?: SqlParameterValue;
     max?: SqlParameterValue;
     like?: string;
@@ -37,7 +41,13 @@ export type FilterConditionValue = SqlParameterValue | SqlParameterValue[] | {
         [operator: string]: SqlParameterValue | string;
     }[];
     column?: string;
-};
+    exists?: ExistsSubqueryDefinition;
+    notExists?: ExistsSubqueryDefinition;
+}
+export interface MultiColumnExistsDefinition extends ExistsSubqueryDefinition {
+    on: string[];
+}
+export type FilterConditionValue = SqlParameterValue | SqlParameterValue[] | FilterConditionObject | MultiColumnExistsDefinition[];
 /**
  * Filter conditions for dynamic query building.
  *
@@ -92,6 +102,36 @@ export interface QueryBuildOptions {
      * @default true
      */
     jsonb?: boolean;
+    /**
+     * Throw when column-anchored EXISTS filters fail to resolve.
+     * Defaults to false so invalid definitions are skipped silently.
+     */
+    existsStrict?: boolean;
+    /**
+     * Schema metadata used when removing unused LEFT JOINs; overrides builder defaults.
+     */
+    schemaInfo?: SchemaInfo;
+    /**
+     * Remove unused LEFT JOINs before further processing when schema info is available.
+     */
+    removeUnusedLeftJoins?: boolean;
+    /**
+     * Remove unused Common Table Expressions (CTEs) when they can be safely pruned.
+     * Defaults to false to preserve original WITH definitions.
+     */
+    removeUnusedCtes?: boolean;
+}
+/**
+ * Builder-level configuration that can be reused across multiple build calls.
+ */
+export interface DynamicQueryBuilderOptions {
+    /** Optional resolver for table column names (retains backward compatibility). */
+    tableColumnResolver?: (tableName: string) => string[];
+    /**
+     * Schema metadata that may be applied by default when the optimizer is enabled.
+     * Schema info provided via QueryBuildOptions takes precedence.
+     */
+    schemaInfo?: SchemaInfo;
 }
 /**
  * DynamicQueryBuilder combines SQL parsing with dynamic condition injection (filters, sorts, paging, JSON serialization).
@@ -103,11 +143,14 @@ export interface QueryBuildOptions {
  */
 export declare class DynamicQueryBuilder {
     private tableColumnResolver?;
+    private defaultSchemaInfo?;
     /**
-     * Creates a new DynamicQueryBuilder instance
-     * @param tableColumnResolver Optional function to resolve table columns for wildcard queries
+     * Creates a new DynamicQueryBuilder instance.
+     * Accepts either the legacy table resolver or an options object that can provide schema metadata.
+     *
+     * @param resolverOrOptions Optional resolver or configuration object
      */
-    constructor(tableColumnResolver?: (tableName: string) => string[]);
+    constructor(resolverOrOptions?: ((tableName: string) => string[]) | DynamicQueryBuilderOptions);
     /**
      * Builds a SelectQuery from SQL content with dynamic conditions.
      * This is a pure function that does not perform any I/O operations.
@@ -129,6 +172,13 @@ export declare class DynamicQueryBuilder {
      * ```
      */
     buildQuery(sqlContent: string, options?: QueryBuildOptions): SelectQuery;
+    private extractExistsInstructions;
+    private handleMultiAnchorDefinitions;
+    private splitExistsProperties;
+    private isFilterConditionObject;
+    private isMultiColumnDefinitionArray;
+    private isMultiColumnDefinition;
+    private createExistsInstruction;
     /**
      * Builds a SelectQuery with only filtering applied.
      * Convenience method for when you only need dynamic WHERE conditions.

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

@@ -0,0 +1,33 @@
+import { SelectQuery } from "../models/SelectQuery";
+import { SqlParameterValue } from "../models/ValueComponent";
+/**
+ * Represents an EXISTS / NOT EXISTS instruction derived from filter metadata.
+ */
+export interface ExistsInstruction {
+    mode: "exists" | "notExists";
+    anchorColumns: string[];
+    sql: string;
+    params?: Record<string, SqlParameterValue>;
+}
+/**
+ * Configuration that controls how EXISTS predicates are injected.
+ */
+export interface ExistsPredicateOptions {
+    tableColumnResolver?: (tableName: string) => string[];
+    strict?: boolean;
+}
+/**
+ * Describes a correlated subquery that renders an EXISTS/NOT EXISTS predicate.
+ */
+export interface ExistsSubqueryDefinition {
+    /** SQL that references the `$c#` placeholders for the anchor columns. */
+    sql: string;
+    /** Optional named parameters that the subquery requires. */
+    params?: Record<string, SqlParameterValue>;
+}
+/**
+ * Injects EXISTS/NOT EXISTS predicates into the provided SelectQuery.
+ * Each instruction is evaluated independently so failures can be skipped
+ * when `strict` is false.
+ */
+export declare function injectExistsPredicates(query: SelectQuery, instructions: ExistsInstruction[], options?: ExistsPredicateOptions): SelectQuery;

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

@@ -0,0 +1,33 @@
+import { SelectQuery } from '../models/SelectQuery';
+/**
+ * Captures the schema metadata required to safely evaluate LEFT JOIN removal.
+ */
+export interface SchemaTableInfo {
+    /** The fully qualified table name that appears in SQL references. */
+    name: string;
+    /** Column names that exist on the table for any schema validation steps. */
+    columns: string[];
+    /**
+     * Unique key declarations for the table.
+     * Each entry is an array of column names that together form a uniqueness constraint.
+     */
+    uniqueKeys: string[][];
+}
+/** Ordered set of table metadata consumed by the optimizer. */
+export type SchemaInfo = SchemaTableInfo[];
+/**
+ * Removes LEFT JOIN clauses from the provided query when AST references prove the join target is unused and schema metadata certifies the join column is unique.
+ */
+export declare const optimizeUnusedLeftJoins: (query: SelectQuery, schemaInfo: SchemaInfo) => SelectQuery;
+/**
+ * Applies the unused left join optimizer until no further joins can be trimmed, ensuring cascading removals stabilize.
+ */
+export declare const optimizeUnusedLeftJoinsToFixedPoint: (query: SelectQuery, schemaInfo: SchemaInfo) => SelectQuery;
+/**
+ * Removes unused SELECT-only CTEs from the query when AST references confirm they are never consumed.
+ */
+export declare const optimizeUnusedCtes: (query: SelectQuery) => SelectQuery;
+/**
+ * Repeatedly prunes unused CTEs until a fixed point is reached so chained removals complete deterministically.
+ */
+export declare const optimizeUnusedCtesToFixedPoint: (query: SelectQuery) => SelectQuery;

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

@@ -27,7 +27,7 @@ export declare class SqlParamInjector {
      * @returns The modified SelectQuery
      * @throws Error when all parameters are undefined and allowAllUndefined is not set to true
      */
-    inject(query: SimpleSelectQuery | string, state: Record<string, number | string | boolean | Date | null | undefined | Condition>): SelectQuery;
+    inject(query: SimpleSelectQuery | string, state: Record<string, StateParameterValue | null | undefined>): SelectQuery;
     /**
      * Type guard for OR conditions
      */

package/dist/src/utils/serialTypeNormalization.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Converts Postgres serial pseudo-type names into their real storage types so ZTD
+ * cast expressions never emit non-existent types.
+ *
+ * @param typeName Optional type name (possibly qualified) that is trimmed before normalization.
+ * @returns The normalized type name when a pseudo-type matches, the trimmed input when no match is found, or `undefined` when the argument is `undefined`.
+ * @example
+ * normalizeSerialPseudoType('serial') // 'integer'
+ * normalizeSerialPseudoType('public.BIGSERIAL') // 'public.bigint'
+ */
+export declare function normalizeSerialPseudoType(typeName?: string): string | undefined;

package/dist/transformers/DynamicQueryBuilder.js

@@ -9,6 +9,8 @@ const PostgresJsonQueryBuilder_1 = require("./PostgresJsonQueryBuilder");
 const QueryBuilder_1 = require("./QueryBuilder");
 const SqlParameterBinder_1 = require("./SqlParameterBinder");
 const ParameterDetector_1 = require("../utils/ParameterDetector");
+const ExistsPredicateInjector_1 = require("./ExistsPredicateInjector");
+const OptimizeUnusedLeftJoins_1 = require("./OptimizeUnusedLeftJoins");
 /**
  * DynamicQueryBuilder combines SQL parsing with dynamic condition injection (filters, sorts, paging, JSON serialization).
  *
@@ -19,11 +21,19 @@ const ParameterDetector_1 = require("../utils/ParameterDetector");
  */
 class DynamicQueryBuilder {
     /**
-     * Creates a new DynamicQueryBuilder instance
-     * @param tableColumnResolver Optional function to resolve table columns for wildcard queries
+     * Creates a new DynamicQueryBuilder instance.
+     * Accepts either the legacy table resolver or an options object that can provide schema metadata.
+     *
+     * @param resolverOrOptions Optional resolver or configuration object
      */
-    constructor(tableColumnResolver) {
-        this.tableColumnResolver = tableColumnResolver;
+    constructor(resolverOrOptions) {
+        if (typeof resolverOrOptions === "function") {
+            this.tableColumnResolver = resolverOrOptions;
+        }
+        else if (resolverOrOptions) {
+            this.tableColumnResolver = resolverOrOptions.tableColumnResolver;
+            this.defaultSchemaInfo = resolverOrOptions.schemaInfo;
+        }
     }
     /**
      * Builds a SelectQuery from SQL content with dynamic conditions.
@@ -46,6 +56,7 @@ class DynamicQueryBuilder {
      * ```
      */
     buildQuery(sqlContent, options = {}) {
+        var _a;
         // Parse the base SQL
         let parsedQuery;
         try {
@@ -64,12 +75,19 @@ class DynamicQueryBuilder {
                 const parameterBinder = new SqlParameterBinder_1.SqlParameterBinder({ requireAllParameters: false });
                 modifiedQuery = parameterBinder.bind(modifiedQuery, hardcodedParams);
             }
-            // Apply dynamic filtering only if there are non-hardcoded filters
-            if (Object.keys(dynamicFilters).length > 0) {
+            // Extract and remove any column-anchored EXISTS filters before injecting traditional ones.
+            const { filters: cleanedFilters, instructions: existsInstructions } = this.extractExistsInstructions(dynamicFilters);
+            if (Object.keys(cleanedFilters).length > 0) {
                 const paramInjector = new SqlParamInjector_1.SqlParamInjector(this.tableColumnResolver);
                 // Ensure we have a SimpleSelectQuery for the injector
                 const simpleQuery = QueryBuilder_1.QueryBuilder.buildSimpleQuery(modifiedQuery);
-                modifiedQuery = paramInjector.inject(simpleQuery, dynamicFilters);
+                modifiedQuery = paramInjector.inject(simpleQuery, cleanedFilters);
+            }
+            if (existsInstructions.length > 0) {
+                modifiedQuery = (0, ExistsPredicateInjector_1.injectExistsPredicates)(modifiedQuery, existsInstructions, {
+                    tableColumnResolver: this.tableColumnResolver,
+                    strict: !!options.existsStrict
+                });
             }
         }
         // 2. Apply sorting second (after filtering to sort smaller dataset)
@@ -78,7 +96,8 @@ class DynamicQueryBuilder {
             // Ensure we have a SimpleSelectQuery for the injector
             const simpleQuery = QueryBuilder_1.QueryBuilder.buildSimpleQuery(modifiedQuery);
             modifiedQuery = sortInjector.inject(simpleQuery, options.sort);
-        } // 3. Apply pagination third (after filtering and sorting)
+        }
+        // 3. Apply pagination third (after filtering and sorting)
         if (options.paging) {
             const { page = 1, pageSize } = options.paging;
             if (pageSize !== undefined) {
@@ -89,7 +108,16 @@ class DynamicQueryBuilder {
                 modifiedQuery = paginationInjector.inject(simpleQuery, paginationOptions);
             }
         }
-        // 4. Apply serialization last (transform the final query structure to JSON)
+        // 4. Remove unused LEFT JOINs when asked before serialization.
+        const effectiveSchemaInfo = (_a = options.schemaInfo) !== null && _a !== void 0 ? _a : this.defaultSchemaInfo;
+        if (options.removeUnusedLeftJoins && (effectiveSchemaInfo === null || effectiveSchemaInfo === void 0 ? void 0 : effectiveSchemaInfo.length)) {
+            modifiedQuery = (0, OptimizeUnusedLeftJoins_1.optimizeUnusedLeftJoinsToFixedPoint)(modifiedQuery, effectiveSchemaInfo);
+        }
+        // Remove unused CTEs before serialization when requested.
+        if (options.removeUnusedCtes) {
+            modifiedQuery = (0, OptimizeUnusedLeftJoins_1.optimizeUnusedCtesToFixedPoint)(modifiedQuery);
+        }
+        // Apply serialization last (transform the final query structure to JSON)
         // Note: boolean values are handled at RawSqlClient level for auto-loading
         if (options.serialize && typeof options.serialize === 'object') {
             const jsonBuilder = new PostgresJsonQueryBuilder_1.PostgresJsonQueryBuilder();
@@ -99,6 +127,83 @@ class DynamicQueryBuilder {
         }
         return modifiedQuery;
     }
+    extractExistsInstructions(filters) {
+        const cleanedFilters = {};
+        const instructions = [];
+        for (const [key, value] of Object.entries(filters)) {
+            if (key === "$exists" || key === "$notExists") {
+                // Multi-anchor metadata arrives as arrays keyed by the special markers.
+                if (!this.isMultiColumnDefinitionArray(value)) {
+                    throw new Error(`'${key}' must be an array of EXISTS definitions.`);
+                }
+                this.handleMultiAnchorDefinitions(key, value, instructions);
+                continue;
+            }
+            if (this.isFilterConditionObject(value)) {
+                const { leftover, exists, notExists } = this.splitExistsProperties(value);
+                if (exists) {
+                    instructions.push(this.createExistsInstruction([key], exists, "exists"));
+                }
+                if (notExists) {
+                    instructions.push(this.createExistsInstruction([key], notExists, "notExists"));
+                }
+                if (leftover) {
+                    cleanedFilters[key] = leftover;
+                }
+                continue;
+            }
+            if (this.isMultiColumnDefinitionArray(value)) {
+                continue;
+            }
+            cleanedFilters[key] = value;
+        }
+        return { filters: cleanedFilters, instructions };
+    }
+    handleMultiAnchorDefinitions(key, definitions, instructions) {
+        // Build instructions for each multi-anchor definition in the batch.
+        for (const definition of definitions) {
+            if (!definition.on || definition.on.length === 0) {
+                throw new Error(`Every ${key} instruction must specify an "on" array.`);
+            }
+            instructions.push(this.createExistsInstruction(definition.on, definition, key === "$notExists" ? "notExists" : "exists"));
+        }
+    }
+    splitExistsProperties(value) {
+        const { exists, notExists, ...rest } = value;
+        const hasRemaining = Object.keys(rest).length > 0;
+        return {
+            leftover: hasRemaining ? rest : undefined,
+            exists: exists,
+            notExists: notExists
+        };
+    }
+    isFilterConditionObject(value) {
+        return value !== null && typeof value === "object" && !Array.isArray(value);
+    }
+    isMultiColumnDefinitionArray(value) {
+        return Array.isArray(value) && value.every(entry => this.isMultiColumnDefinition(entry));
+    }
+    isMultiColumnDefinition(value) {
+        if (!value || typeof value !== "object") {
+            return false;
+        }
+        const candidate = value;
+        return (Array.isArray(candidate.on) &&
+            candidate.on.length > 0 &&
+            candidate.on.every(column => typeof column === "string") &&
+            typeof candidate.sql === "string");
+    }
+    createExistsInstruction(anchors, definition, mode) {
+        if (!definition.sql || typeof definition.sql !== "string") {
+            throw new Error("EXISTS definition must include a SQL string.");
+        }
+        return {
+            mode,
+            anchorColumns: anchors,
+            sql: definition.sql,
+            params: definition.params
+        };
+    }
     /**
      * Builds a SelectQuery with only filtering applied.
      * Convenience method for when you only need dynamic WHERE conditions.

package/dist/transformers/DynamicQueryBuilder.js.map

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