rawsql-ts 0.16.0 → 0.18.0

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

@@ -3,18 +3,23 @@ import { SortConditions } from "./SqlSortInjector";
 import { PaginationOptions } from "./SqlPaginationInjector";
 import { JsonMapping } from "./PostgresJsonQueryBuilder";
 import { SqlParameterValue } from "../models/ValueComponent";
+import { SchemaInfo } from "./OptimizeUnusedLeftJoins";
+import { OptionalConditionParameterStates, OptionalConditionPruningParameters } from "./PruneOptionalConditionBranches";
+import type { ExistsSubqueryDefinition } from "./ExistsPredicateInjector";
+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 +42,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.
  *
@@ -74,12 +85,25 @@ export type FilterConditions = Record<string, FilterConditionValue>;
  * Options for dynamic query building
  */
 export interface QueryBuildOptions {
-    /** Filter conditions to inject into WHERE clause */
+    /**
+     * Legacy filter input for named-parameter binding only.
+     * Dynamic predicate injection is no longer supported and will fail fast.
+     */
     filter?: FilterConditions;
     /** Sort conditions to inject into ORDER BY clause */
     sort?: SortConditions;
     /** Pagination options to inject LIMIT/OFFSET clauses */
     paging?: PaginationOptions;
+    /**
+     * Columns that should remain in the SELECT clause.
+     * When specified, every other column is removed so the output matches this whitelist.
+     */
+    includeColumns?: string[];
+    /**
+     * Columns that should be removed from the SELECT clause.
+     * Filters apply subtractively and only drop columns that exist in the original output.
+     */
+    excludeColumns?: string[];
     /** JSON serialization mapping to transform results into hierarchical JSON
      * - JsonMapping object: explicit mapping configuration
      * - true: auto-load mapping from corresponding .json file
@@ -92,6 +116,46 @@ 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;
+    /**
+     * Explicit opt-in values for truthful optional condition branches in source SQL.
+     * Only listed parameter names are eligible for pruning, and `null`/`undefined` are treated as absent-equivalent.
+     */
+    optionalConditionParameters?: OptionalConditionPruningParameters;
+    /**
+     * Legacy state-map form for optional branch pruning.
+     * Prefer `optionalConditionParameters` for new code so SQL-facing null semantics stay intuitive.
+     */
+    optionalConditionParameterStates?: OptionalConditionParameterStates;
+}
+/**
+ * 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 +167,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,13 +196,18 @@ export declare class DynamicQueryBuilder {
      * ```
      */
     buildQuery(sqlContent: string, options?: QueryBuildOptions): SelectQuery;
+    private resolveOptionalConditionPruningParameters;
+    private applyColumnFilters;
+    private normalizeColumnList;
+    private normalizeColumnIdentifier;
+    private getSelectItemName;
     /**
-     * Builds a SelectQuery with only filtering applied.
-     * Convenience method for when you only need dynamic WHERE conditions.
+     * Legacy helper for binding existing named parameters without adding new runtime predicates.
+     * Dynamic WHERE-condition injection is no longer supported; use SSSQL scaffold/refresh instead.
      *
      * @param sqlContent Raw SQL string to parse and modify
-     * @param filter Filter conditions to apply
-     * @returns Modified SelectQuery with filter conditions applied
+     * @param filter Named parameters to bind when they already exist in the SQL
+     * @returns Modified SelectQuery after binding existing named parameters
      */
     buildFilteredQuery(sqlContent: string, filter: FilterConditions): SelectQuery;
     /**

package/dist/esm/transformers/DynamicQueryBuilder.js

@@ -1,11 +1,13 @@
 import { SelectQueryParser } from "../parsers/SelectQueryParser";
-import { SqlParamInjector } from "./SqlParamInjector";
 import { SqlSortInjector } from "./SqlSortInjector";
 import { SqlPaginationInjector } from "./SqlPaginationInjector";
 import { PostgresJsonQueryBuilder } from "./PostgresJsonQueryBuilder";
 import { QueryBuilder } from "./QueryBuilder";
 import { SqlParameterBinder } from "./SqlParameterBinder";
 import { ParameterDetector } from "../utils/ParameterDetector";
+import { ColumnReference } from "../models/ValueComponent";
+import { optimizeUnusedLeftJoinsToFixedPoint, optimizeUnusedCtesToFixedPoint } from "./OptimizeUnusedLeftJoins";
+import { pruneOptionalConditionBranches } from "./PruneOptionalConditionBranches";
 /**
  * DynamicQueryBuilder combines SQL parsing with dynamic condition injection (filters, sorts, paging, JSON serialization).
  *
@@ -16,11 +18,19 @@ import { ParameterDetector } from "../utils/ParameterDetector";
  */
 export 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.
@@ -43,6 +53,7 @@ export class DynamicQueryBuilder {
      * ```
      */
     buildQuery(sqlContent, options = {}) {
+        var _a;
         // Parse the base SQL
         let parsedQuery;
         try {
@@ -53,7 +64,7 @@ export class DynamicQueryBuilder {
         }
         // Apply dynamic modifications in the correct order
         let modifiedQuery = parsedQuery;
-        // 1. Bind hardcoded parameters first (before any other transformations)
+        // 1. Bind existing named parameters, but fail fast for legacy runtime filter assembly.
         if (options.filter && Object.keys(options.filter).length > 0) {
             const { hardcodedParams, dynamicFilters } = ParameterDetector.separateFilters(modifiedQuery, options.filter);
             // Bind hardcoded parameters if any exist
@@ -61,12 +72,9 @@ export class DynamicQueryBuilder {
                 const parameterBinder = new SqlParameterBinder({ requireAllParameters: false });
                 modifiedQuery = parameterBinder.bind(modifiedQuery, hardcodedParams);
             }
-            // Apply dynamic filtering only if there are non-hardcoded filters
-            if (Object.keys(dynamicFilters).length > 0) {
-                const paramInjector = new SqlParamInjector(this.tableColumnResolver);
-                // Ensure we have a SimpleSelectQuery for the injector
-                const simpleQuery = QueryBuilder.buildSimpleQuery(modifiedQuery);
-                modifiedQuery = paramInjector.inject(simpleQuery, dynamicFilters);
+            const hasLegacyDynamicFilters = Object.keys(dynamicFilters).length > 0;
+            if (hasLegacyDynamicFilters) {
+                throw new Error("DynamicQueryBuilder no longer injects runtime filter predicates. Use `ztd query sssql scaffold` to author optional filters, `ztd query sssql refresh` to refresh them, and `optionalConditionParameters` at runtime for pruning only.");
             }
         }
         // 2. Apply sorting second (after filtering to sort smaller dataset)
@@ -75,7 +83,8 @@ export class DynamicQueryBuilder {
             // Ensure we have a SimpleSelectQuery for the injector
             const simpleQuery = 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) {
@@ -86,7 +95,23 @@ export class DynamicQueryBuilder {
                 modifiedQuery = paginationInjector.inject(simpleQuery, paginationOptions);
             }
         }
-        // 4. Apply serialization last (transform the final query structure to JSON)
+        // 4. Apply column projection filters before any optimizer passes.
+        modifiedQuery = this.applyColumnFilters(modifiedQuery, options);
+        // 5. Prune supported truthful optional branches before structural optimizers.
+        const optionalConditionParameters = this.resolveOptionalConditionPruningParameters(options);
+        if (Object.keys(optionalConditionParameters).length > 0) {
+            modifiedQuery = pruneOptionalConditionBranches(modifiedQuery, optionalConditionParameters);
+        }
+        // 6. 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 = optimizeUnusedLeftJoinsToFixedPoint(modifiedQuery, effectiveSchemaInfo);
+        }
+        // 7. Remove unused CTEs before serialization when requested.
+        if (options.removeUnusedCtes) {
+            modifiedQuery = 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();
@@ -96,13 +121,116 @@ export class DynamicQueryBuilder {
         }
         return modifiedQuery;
     }
+    resolveOptionalConditionPruningParameters(options) {
+        if (options.optionalConditionParameters) {
+            return options.optionalConditionParameters;
+        }
+        if (!options.optionalConditionParameterStates) {
+            return {};
+        }
+        const legacyParameters = {};
+        // Preserve backward compatibility for the state-map API while the value-based API becomes the primary entry point.
+        for (const [parameterName, state] of Object.entries(options.optionalConditionParameterStates)) {
+            legacyParameters[parameterName] = state === 'absent'
+                ? null
+                : '__RAWSQL_OPTIONAL_CONDITION_PRESENT__';
+        }
+        return legacyParameters;
+    }
+    applyColumnFilters(query, options) {
+        const hasIncludeFilters = Array.isArray(options.includeColumns) && options.includeColumns.length > 0;
+        const hasExcludeFilters = Array.isArray(options.excludeColumns) && options.excludeColumns.length > 0;
+        if (!hasIncludeFilters && !hasExcludeFilters) {
+            return query;
+        }
+        if (hasIncludeFilters && hasExcludeFilters) {
+            throw new Error("includeColumns and excludeColumns cannot be used together.");
+        }
+        const simpleQuery = QueryBuilder.buildSimpleQuery(query);
+        const metadata = simpleQuery.selectClause.items.map(item => {
+            const name = this.getSelectItemName(item);
+            return {
+                item,
+                normalized: name ? this.normalizeColumnIdentifier(name) : null
+            };
+        });
+        const availableColumns = new Set(metadata
+            .map(entry => entry.normalized)
+            .filter((name) => name !== null));
+        const includeFilters = hasIncludeFilters ? this.normalizeColumnList(options.includeColumns) : null;
+        const excludeFilters = hasExcludeFilters ? this.normalizeColumnList(options.excludeColumns) : null;
+        const includeSet = includeFilters ? new Set(includeFilters.map(entry => entry.normalized)) : null;
+        const excludeSet = excludeFilters ? new Set(excludeFilters.map(entry => entry.normalized)) : null;
+        if (includeFilters) {
+            const missing = includeFilters.filter(entry => !availableColumns.has(entry.normalized));
+            if (missing.length > 0) {
+                throw new Error(`Column${missing.length === 1 ? "" : "s"} not found in SELECT clause: ${missing
+                    .map(entry => `'${entry.original}'`)
+                    .join(", ")}.`);
+            }
+        }
+        if (excludeFilters) {
+            const missing = excludeFilters.filter(entry => !availableColumns.has(entry.normalized));
+            if (missing.length > 0) {
+                throw new Error(`Column${missing.length === 1 ? "" : "s"} not found in SELECT clause: ${missing
+                    .map(entry => `'${entry.original}'`)
+                    .join(", ")}.`);
+            }
+        }
+        const filteredItems = metadata
+            .filter(entry => {
+            if (!entry.normalized) {
+                return true;
+            }
+            if (includeSet) {
+                return includeSet.has(entry.normalized);
+            }
+            if (excludeSet) {
+                return !excludeSet.has(entry.normalized);
+            }
+            return true;
+        })
+            .map(entry => entry.item);
+        if (filteredItems.length === 0) {
+            throw new Error("Column filtering removed every SELECT item.");
+        }
+        simpleQuery.selectClause.items = filteredItems;
+        return simpleQuery;
+    }
+    normalizeColumnList(columns) {
+        return columns.map(column => {
+            if (typeof column !== "string") {
+                throw new Error("Column filters must be strings.");
+            }
+            const trimmed = column.trim();
+            if (trimmed === "") {
+                throw new Error("Column filters must not be empty.");
+            }
+            return {
+                normalized: this.normalizeColumnIdentifier(trimmed),
+                original: trimmed
+            };
+        });
+    }
+    normalizeColumnIdentifier(value) {
+        return value.trim().toLowerCase();
+    }
+    getSelectItemName(item) {
+        if (item.identifier) {
+            return item.identifier.name;
+        }
+        if (item.value instanceof ColumnReference) {
+            return item.value.column.name;
+        }
+        return null;
+    }
     /**
-     * Builds a SelectQuery with only filtering applied.
-     * Convenience method for when you only need dynamic WHERE conditions.
+     * Legacy helper for binding existing named parameters without adding new runtime predicates.
+     * Dynamic WHERE-condition injection is no longer supported; use SSSQL scaffold/refresh instead.
      *
      * @param sqlContent Raw SQL string to parse and modify
-     * @param filter Filter conditions to apply
-     * @returns Modified SelectQuery with filter conditions applied
+     * @param filter Named parameters to bind when they already exist in the SQL
+     * @returns Modified SelectQuery after binding existing named parameters
      */
     buildFilteredQuery(sqlContent, filter) {
         return this.buildQuery(sqlContent, { filter });

package/dist/esm/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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"}

package/dist/esm/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;