blendsdk 5.33.0

package/dist/dbcore/update-statement.js

@@ -0,0 +1,52 @@
+import { FilterableStatement } from './filterable-statement.js';
+/**
+ * Abstract statement builder for UPDATE operations.
+ * Extends FilterableStatement to provide functionality for updating existing records in database tables.
+ * Concrete database implementations must extend this class to provide database-specific
+ * UPDATE query construction and parameter handling.
+ *
+ * This class provides a fluent interface for building UPDATE statements with support
+ * for filtering which records to update and RETURNING clauses to retrieve updated data.
+ *
+ * @export
+ * @abstract
+ * @class UpdateStatement
+ * @extends {FilterableStatement<TableType, FilterType>}
+ * @template TableType - The type representing the table structure for updates
+ * @template FilterType - The type representing the filter criteria structure
+ */
+export class UpdateStatement extends FilterableStatement {
+    /**
+     * Creates an instance of UpdateStatement.
+     * Initializes the statement with a table name and database connection.
+     *
+     * @param {string} tableName - The name of the table to update
+     * @param {Database} db - The database instance to execute queries against
+     * @memberof UpdateStatement
+     */
+    constructor(tableName, db) {
+        super(tableName, db);
+    }
+    /**
+     * Sets the values to be updated in the table.
+     * Accepts a partial object where keys represent column names and values
+     * represent the new data. Only the specified columns will be updated.
+     *
+     * @param {Partial<TableType>} values - Object containing column names and new values
+     * @return {this} The statement instance for method chaining
+     * @memberof UpdateStatement
+     *
+     * @example
+     * // Update user fields
+     * statement.values({
+     *   name: 'Jane Doe',
+     *   email: 'jane@example.com',
+     *   updated_at: new Date()
+     * })
+     */
+    values(values) {
+        this._values = values;
+        return this;
+    }
+}
+//# sourceMappingURL=update-statement.js.map

package/dist/dbcore/update-statement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-statement.js","sourceRoot":"","sources":["../src/update-statement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAGhE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAgB,eAAuC,SAAQ,mBAGpE;IACC;;;;;;;OAOG;IACH,YAAY,SAAiB,EAAE,EAAY;QACzC,KAAK,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,MAA0B;QAC/B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/expression/builders/comparison-builder.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Comparison builder implementation
+ * Provides fluent API for building comparison expressions
+ */
+import { ParameterManager } from '../core/parameter-manager.js';
+import { SearchOptions, ASTNode } from '../core/types.js';
+import { ComparisonBuilder, QueryBuilder } from '../core/query-builder-interfaces.js';
+/**
+ * Comparison builder implementation
+ */
+export declare class ComparisonBuilderImpl<TSchema, K extends keyof TSchema> implements ComparisonBuilder<TSchema, K> {
+    private readonly column;
+    private readonly queryBuilder;
+    private readonly paramManager;
+    private readonly addNode;
+    constructor(column: string, queryBuilder: QueryBuilder<TSchema>, paramManager: ParameterManager, addNode: (node: ASTNode) => QueryBuilder<TSchema>);
+    equals(value: TSchema[K]): QueryBuilder<TSchema>;
+    notEquals(value: TSchema[K]): QueryBuilder<TSchema>;
+    greaterThan(value: TSchema[K]): QueryBuilder<TSchema>;
+    greaterThanOrEqual(value: TSchema[K]): QueryBuilder<TSchema>;
+    lessThan(value: TSchema[K]): QueryBuilder<TSchema>;
+    lessThanOrEqual(value: TSchema[K]): QueryBuilder<TSchema>;
+    between(min: TSchema[K], max: TSchema[K]): QueryBuilder<TSchema>;
+    notBetween(min: TSchema[K], max: TSchema[K]): QueryBuilder<TSchema>;
+    in(values: TSchema[K][]): QueryBuilder<TSchema>;
+    notIn(values: TSchema[K][]): QueryBuilder<TSchema>;
+    like(pattern: string): QueryBuilder<TSchema>;
+    ilike(pattern: string): QueryBuilder<TSchema>;
+    isNull(): QueryBuilder<TSchema>;
+    isNotNull(): QueryBuilder<TSchema>;
+    startsWith(value: string): QueryBuilder<TSchema>;
+    endsWith(value: string): QueryBuilder<TSchema>;
+    contains(value: string): QueryBuilder<TSchema>;
+    jsonContains(value: any): QueryBuilder<TSchema>;
+    jsonContainedBy(value: any): QueryBuilder<TSchema>;
+    jsonHasKey(key: string): QueryBuilder<TSchema>;
+    jsonHasAnyKey(keys: string[]): QueryBuilder<TSchema>;
+    jsonHasAllKeys(keys: string[]): QueryBuilder<TSchema>;
+    jsonPathExists(path: string): QueryBuilder<TSchema>;
+    search(query: string, options?: SearchOptions): QueryBuilder<TSchema>;
+    exists(subquery: QueryBuilder<any>): QueryBuilder<TSchema>;
+    notExists(subquery: QueryBuilder<any>): QueryBuilder<TSchema>;
+    inSubquery(subquery: QueryBuilder<any>): QueryBuilder<TSchema>;
+    notInSubquery(subquery: QueryBuilder<any>): QueryBuilder<TSchema>;
+    equalsColumn(column: string): QueryBuilder<TSchema>;
+}
+//# sourceMappingURL=comparison-builder.d.ts.map

package/dist/expression/builders/comparison-builder.d.ts.map

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

package/dist/expression/builders/comparison-builder.js

@@ -0,0 +1,197 @@
+/**
+ * Comparison builder implementation
+ * Provides fluent API for building comparison expressions
+ */
+import { createComparisonNode, createJsonNode, createFullTextNode, createSubqueryNode, } from '../core/ast-node.js';
+import { ComparisonOperator, JsonOperator, FullTextMode, } from '../core/types.js';
+/**
+ * Comparison builder implementation
+ */
+export class ComparisonBuilderImpl {
+    column;
+    queryBuilder;
+    paramManager;
+    addNode;
+    constructor(column, queryBuilder, paramManager, addNode) {
+        this.column = column;
+        this.queryBuilder = queryBuilder;
+        this.paramManager = paramManager;
+        this.addNode = addNode;
+    }
+    equals(value) {
+        const paramName = this.paramManager.addParameterWithValue(value);
+        const node = createComparisonNode(this.column, ComparisonOperator.Equal, value, undefined, [paramName]);
+        return this.addNode(node);
+    }
+    notEquals(value) {
+        const paramName = this.paramManager.addParameterWithValue(value);
+        const node = createComparisonNode(this.column, ComparisonOperator.NotEqual, value, undefined, [paramName]);
+        return this.addNode(node);
+    }
+    greaterThan(value) {
+        const paramName = this.paramManager.addParameterWithValue(value);
+        const node = createComparisonNode(this.column, ComparisonOperator.GreaterThan, value, undefined, [paramName]);
+        return this.addNode(node);
+    }
+    greaterThanOrEqual(value) {
+        const paramName = this.paramManager.addParameterWithValue(value);
+        const node = createComparisonNode(this.column, ComparisonOperator.GreaterThanOrEqual, value, undefined, [paramName]);
+        return this.addNode(node);
+    }
+    lessThan(value) {
+        const paramName = this.paramManager.addParameterWithValue(value);
+        const node = createComparisonNode(this.column, ComparisonOperator.LessThan, value, undefined, [paramName]);
+        return this.addNode(node);
+    }
+    lessThanOrEqual(value) {
+        const paramName = this.paramManager.addParameterWithValue(value);
+        const node = createComparisonNode(this.column, ComparisonOperator.LessThanOrEqual, value, undefined, [paramName]);
+        return this.addNode(node);
+    }
+    between(min, max) {
+        const minParamName = this.paramManager.addParameterWithValue(min);
+        const maxParamName = this.paramManager.addParameterWithValue(max);
+        const node = createComparisonNode(this.column, ComparisonOperator.Between, undefined, [min, max], [minParamName, maxParamName]);
+        return this.addNode(node);
+    }
+    notBetween(min, max) {
+        const minParamName = this.paramManager.addParameterWithValue(min);
+        const maxParamName = this.paramManager.addParameterWithValue(max);
+        const node = createComparisonNode(this.column, ComparisonOperator.NotBetween, undefined, [min, max], [minParamName, maxParamName]);
+        return this.addNode(node);
+    }
+    in(values) {
+        const paramNames = values.map(v => this.paramManager.addParameterWithValue(v));
+        const node = createComparisonNode(this.column, ComparisonOperator.In, undefined, values, paramNames);
+        return this.addNode(node);
+    }
+    notIn(values) {
+        const paramNames = values.map(v => this.paramManager.addParameterWithValue(v));
+        const node = createComparisonNode(this.column, ComparisonOperator.NotIn, undefined, values, paramNames);
+        return this.addNode(node);
+    }
+    like(pattern) {
+        const paramName = this.paramManager.addParameterWithValue(pattern);
+        const node = createComparisonNode(this.column, ComparisonOperator.Like, pattern, undefined, [paramName]);
+        return this.addNode(node);
+    }
+    ilike(pattern) {
+        const paramName = this.paramManager.addParameterWithValue(pattern);
+        const node = createComparisonNode(this.column, ComparisonOperator.ILike, pattern, undefined, [paramName]);
+        return this.addNode(node);
+    }
+    isNull() {
+        const node = createComparisonNode(this.column, ComparisonOperator.IsNull);
+        return this.addNode(node);
+    }
+    isNotNull() {
+        const node = createComparisonNode(this.column, ComparisonOperator.IsNotNull);
+        return this.addNode(node);
+    }
+    startsWith(value) {
+        return this.like(`${value}%`);
+    }
+    endsWith(value) {
+        return this.like(`%${value}`);
+    }
+    contains(value) {
+        return this.like(`%${value}%`);
+    }
+    jsonContains(value) {
+        const paramName = this.paramManager.addParameterWithValue(value);
+        const node = createJsonNode(this.column, JsonOperator.Contains, {
+            value,
+            parameterName: paramName,
+        });
+        return this.addNode(node);
+    }
+    jsonContainedBy(value) {
+        const paramName = this.paramManager.addParameterWithValue(value);
+        const node = createJsonNode(this.column, JsonOperator.ContainedBy, {
+            value,
+            parameterName: paramName,
+        });
+        return this.addNode(node);
+    }
+    jsonHasKey(key) {
+        const paramName = this.paramManager.addParameterWithValue(key);
+        const node = createJsonNode(this.column, JsonOperator.HasKey, {
+            keys: [key],
+            parameterName: paramName,
+        });
+        return this.addNode(node);
+    }
+    jsonHasAnyKey(keys) {
+        const paramName = this.paramManager.addParameterWithValue(keys);
+        const node = createJsonNode(this.column, JsonOperator.HasAnyKey, {
+            keys,
+            parameterName: paramName,
+        });
+        return this.addNode(node);
+    }
+    jsonHasAllKeys(keys) {
+        const paramName = this.paramManager.addParameterWithValue(keys);
+        const node = createJsonNode(this.column, JsonOperator.HasAllKeys, {
+            keys,
+            parameterName: paramName,
+        });
+        return this.addNode(node);
+    }
+    jsonPathExists(path) {
+        const paramName = this.paramManager.addParameterWithValue(path);
+        const node = createJsonNode(this.column, JsonOperator.PathExists, {
+            path,
+            parameterName: paramName,
+        });
+        return this.addNode(node);
+    }
+    search(query, options) {
+        const mode = options?.mode === 'phrase'
+            ? FullTextMode.Phrase
+            : options?.mode === 'websearch'
+                ? FullTextMode.WebSearch
+                : FullTextMode.Plain;
+        const language = options?.language || 'english';
+        const paramName = this.paramManager.addParameterWithValue(query);
+        const node = createFullTextNode([this.column], query, mode, language, paramName);
+        return this.addNode(node);
+    }
+    exists(subquery) {
+        const subqueryAST = subquery.getAST();
+        if (!subqueryAST) {
+            throw new Error('Subquery must have at least one condition');
+        }
+        const node = createSubqueryNode('EXISTS', subqueryAST, this.column);
+        return this.addNode(node);
+    }
+    notExists(subquery) {
+        const subqueryAST = subquery.getAST();
+        if (!subqueryAST) {
+            throw new Error('Subquery must have at least one condition');
+        }
+        const node = createSubqueryNode('NOT EXISTS', subqueryAST, this.column);
+        return this.addNode(node);
+    }
+    inSubquery(subquery) {
+        const subqueryAST = subquery.getAST();
+        if (!subqueryAST) {
+            throw new Error('Subquery must have at least one condition');
+        }
+        const node = createSubqueryNode('IN', subqueryAST, this.column);
+        return this.addNode(node);
+    }
+    notInSubquery(subquery) {
+        const subqueryAST = subquery.getAST();
+        if (!subqueryAST) {
+            throw new Error('Subquery must have at least one condition');
+        }
+        const node = createSubqueryNode('NOT IN', subqueryAST, this.column);
+        return this.addNode(node);
+    }
+    equalsColumn(column) {
+        // For correlated subqueries - column reference without parameter
+        const node = createComparisonNode(this.column, ComparisonOperator.Equal, column, undefined, undefined);
+        return this.addNode(node);
+    }
+}
+//# sourceMappingURL=comparison-builder.js.map

package/dist/expression/builders/comparison-builder.js.map

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

package/dist/expression/builders/query-builder.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Main query builder implementation
+ * Provides the fluent API for building SQL WHERE clauses
+ */
+import { ParameterManager } from '../core/parameter-manager.js';
+import { ComparisonBuilder, QueryBuilder } from '../core/query-builder-interfaces.js';
+import { ASTNode, CompileResult, QueryOptions, SearchOptions } from '../core/types.js';
+/**
+ * Main query builder implementation
+ */
+export declare class QueryBuilderImpl<TSchema = Record<string, any>> implements QueryBuilder<TSchema> {
+    private ast;
+    private readonly paramManager;
+    private readonly dialect;
+    private debugMode;
+    /**
+     * Creates a new QueryBuilderImpl instance.
+     *
+     * @param options - Query builder configuration options
+     * @param parentParamManager - Optional parent parameter manager for nested builders
+     *   to share parameter naming across nested sub-queries
+     */
+    constructor(options?: QueryOptions, parentParamManager?: ParameterManager);
+    /**
+     * Start WHERE clause with a column
+     */
+    where<K extends keyof TSchema>(column: K): ComparisonBuilder<TSchema, K>;
+    where(callback: (q: QueryBuilder<TSchema>) => QueryBuilder<TSchema>): QueryBuilder<TSchema>;
+    /**
+     * Add AND condition with a column
+     */
+    and<K extends keyof TSchema>(column: K): ComparisonBuilder<TSchema, K>;
+    and(callback: (q: QueryBuilder<TSchema>) => QueryBuilder<TSchema>): QueryBuilder<TSchema>;
+    /**
+     * Add OR condition with a column
+     */
+    or<K extends keyof TSchema>(column: K): ComparisonBuilder<TSchema, K>;
+    or(callback: (q: QueryBuilder<TSchema>) => QueryBuilder<TSchema>): QueryBuilder<TSchema>;
+    /**
+     * Full-text search across multiple columns
+     */
+    search(columns: string | string[], query: string, options?: SearchOptions): QueryBuilder<TSchema>;
+    /**
+     * Enable debug mode
+     */
+    debug(): QueryBuilder<TSchema>;
+    /**
+     * Compile the query to SQL
+     */
+    compile(): CompileResult;
+    /**
+     * Get the internal AST
+     */
+    getAST(): ASTNode | null;
+    /**
+     * Create a nested builder that shares the parameter manager.
+     * This ensures parameter naming is consistent across the parent
+     * and nested sub-queries (e.g., grouped WHERE conditions).
+     *
+     * @returns A new QueryBuilderImpl that shares this builder's parameter manager
+     */
+    private createNestedBuilder;
+    /**
+     * Clone this query builder.
+     *
+     * **⚠️ WARNING: Shared state** — The cloned builder gets a **new** parameter manager,
+     * but shares the same AST reference. Modifying the AST in either the original
+     * or the clone may affect the other. Use this for branching query variations,
+     * not for independent copies. If you need fully independent copies, compile
+     * the original first, then build a new query.
+     *
+     * @returns A new QueryBuilder with the same AST but independent parameter manager
+     */
+    clone(): QueryBuilder<TSchema>;
+}
+/**
+ * Create a new query builder
+ */
+export declare function query<TSchema = Record<string, any>>(options?: QueryOptions): QueryBuilder<TSchema>;
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/expression/builders/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../src/builders/query-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACtF,OAAO,EACL,OAAO,EACP,aAAa,EAGb,YAAY,EACZ,aAAa,EAEd,MAAM,kBAAkB,CAAC;AAG1B;;GAEG;AACH,qBAAa,gBAAgB,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,YAAW,YAAY,CAAC,OAAO,CAAC;IAC3F,OAAO,CAAC,GAAG,CAAwB;IACnC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,SAAS,CAAkB;IAEnC;;;;;;OAMG;gBACS,OAAO,GAAE,YAAiB,EAAE,kBAAkB,CAAC,EAAE,gBAAgB;IAM7E;;OAEG;IACH,KAAK,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC;IA8B3F;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC;IAoCzF;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,MAAM,EAAE,CAAC,GAAG,iBAAiB,CAAC,OAAO,EAAE,CAAC,CAAC;IACrE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,YAAY,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC;IAoCxF;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAC1B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,GACtB,YAAY,CAAC,OAAO,CAAC;IAsBxB;;OAEG;IACH,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC;IAK9B;;OAEG;IACH,OAAO,IAAI,aAAa;IAyDxB;;OAEG;IACH,MAAM,IAAI,OAAO,GAAG,IAAI;IAIxB;;;;;;OAMG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;;;;;;;OAUG;IACH,KAAK,IAAI,YAAY,CAAC,OAAO,CAAC;CAQ/B;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjD,OAAO,CAAC,EAAE,YAAY,GACrB,YAAY,CAAC,OAAO,CAAC,CAEvB"}

package/dist/expression/builders/query-builder.js

@@ -0,0 +1,229 @@
+/**
+ * Main query builder implementation
+ * Provides the fluent API for building SQL WHERE clauses
+ */
+import { PostgreSQLCompiler } from '../compiler/postgresql-compiler.js';
+import { createFullTextNode, createGroupNode, createLogicalNode } from '../core/ast-node.js';
+import { ParameterManager } from '../core/parameter-manager.js';
+import { FullTextMode, LogicalOperator, SqlDialect, } from '../core/types.js';
+import { ComparisonBuilderImpl } from './comparison-builder.js';
+/**
+ * Main query builder implementation
+ */
+export class QueryBuilderImpl {
+    ast = null;
+    paramManager;
+    dialect;
+    debugMode = false;
+    /**
+     * Creates a new QueryBuilderImpl instance.
+     *
+     * @param options - Query builder configuration options
+     * @param parentParamManager - Optional parent parameter manager for nested builders
+     *   to share parameter naming across nested sub-queries
+     */
+    constructor(options = {}, parentParamManager) {
+        this.dialect = options.dialect || SqlDialect.PostgreSQL;
+        this.paramManager = parentParamManager || new ParameterManager(this.dialect);
+        this.debugMode = options.debug || false;
+    }
+    where(columnOrCallback) {
+        if (typeof columnOrCallback === 'function') {
+            // Callback for grouping - share parameter manager
+            const nestedBuilder = this.createNestedBuilder();
+            const result = columnOrCallback(nestedBuilder);
+            const nestedAST = result.getAST();
+            if (nestedAST) {
+                const groupNode = createGroupNode(nestedAST);
+                this.ast = groupNode;
+            }
+            return this;
+        }
+        else {
+            // Column comparison
+            return new ComparisonBuilderImpl(String(columnOrCallback), this, this.paramManager, (node) => {
+                this.ast = node;
+                return this;
+            });
+        }
+    }
+    and(columnOrCallback) {
+        if (typeof columnOrCallback === 'function') {
+            // Callback for grouping - share parameter manager
+            const nestedBuilder = this.createNestedBuilder();
+            const result = columnOrCallback(nestedBuilder);
+            const nestedAST = result.getAST();
+            if (nestedAST && this.ast) {
+                const groupNode = createGroupNode(nestedAST);
+                this.ast = createLogicalNode(LogicalOperator.And, this.ast, groupNode);
+            }
+            else if (nestedAST) {
+                this.ast = createGroupNode(nestedAST);
+            }
+            return this;
+        }
+        else {
+            // Column comparison
+            return new ComparisonBuilderImpl(String(columnOrCallback), this, this.paramManager, (node) => {
+                if (this.ast) {
+                    this.ast = createLogicalNode(LogicalOperator.And, this.ast, node);
+                }
+                else {
+                    this.ast = node;
+                }
+                return this;
+            });
+        }
+    }
+    or(columnOrCallback) {
+        if (typeof columnOrCallback === 'function') {
+            // Callback for grouping - share parameter manager
+            const nestedBuilder = this.createNestedBuilder();
+            const result = columnOrCallback(nestedBuilder);
+            const nestedAST = result.getAST();
+            if (nestedAST && this.ast) {
+                const groupNode = createGroupNode(nestedAST);
+                this.ast = createLogicalNode(LogicalOperator.Or, this.ast, groupNode);
+            }
+            else if (nestedAST) {
+                this.ast = createGroupNode(nestedAST);
+            }
+            return this;
+        }
+        else {
+            // Column comparison
+            return new ComparisonBuilderImpl(String(columnOrCallback), this, this.paramManager, (node) => {
+                if (this.ast) {
+                    this.ast = createLogicalNode(LogicalOperator.Or, this.ast, node);
+                }
+                else {
+                    this.ast = node;
+                }
+                return this;
+            });
+        }
+    }
+    /**
+     * Full-text search across multiple columns
+     */
+    search(columns, query, options) {
+        const columnArray = Array.isArray(columns) ? columns : [columns];
+        const mode = options?.mode === 'phrase'
+            ? FullTextMode.Phrase
+            : options?.mode === 'websearch'
+                ? FullTextMode.WebSearch
+                : FullTextMode.Plain;
+        const language = options?.language || 'english';
+        const paramName = this.paramManager.addParameterWithValue(query);
+        const node = createFullTextNode(columnArray, query, mode, language, paramName);
+        if (this.ast) {
+            this.ast = createLogicalNode(LogicalOperator.And, this.ast, node);
+        }
+        else {
+            this.ast = node;
+        }
+        return this;
+    }
+    /**
+     * Enable debug mode
+     */
+    debug() {
+        this.debugMode = true;
+        return this;
+    }
+    /**
+     * Compile the query to SQL
+     */
+    compile() {
+        const startTime = performance.now();
+        if (!this.ast) {
+            return {
+                sql: '',
+                params: {},
+                debug: this.debugMode
+                    ? {
+                        ast: this.ast,
+                        optimizations: [],
+                        parameterCount: 0,
+                        compilationTime: 0,
+                        warnings: ['No conditions specified'],
+                    }
+                    : undefined,
+            };
+        }
+        // Create compiler based on dialect
+        let compiler;
+        switch (this.dialect) {
+            case SqlDialect.PostgreSQL:
+                compiler = new PostgreSQLCompiler(this.paramManager);
+                break;
+            case SqlDialect.MySQL:
+            case SqlDialect.MSSQL:
+            case SqlDialect.SQLite:
+                throw new Error(`Dialect ${this.dialect} is not yet implemented`);
+            default:
+                throw new Error(`Unknown dialect: ${this.dialect}`);
+        }
+        // Compile AST to SQL
+        const sql = compiler.compile(this.ast);
+        const params = this.paramManager.getParameters();
+        const compilationTime = performance.now() - startTime;
+        const result = {
+            sql,
+            params,
+        };
+        // Add debug information if enabled
+        if (this.debugMode) {
+            result.debug = {
+                ast: this.ast,
+                optimizations: compiler.getOptimizations(),
+                parameterCount: this.paramManager.getParameterCount(),
+                compilationTime,
+                warnings: compiler.getWarnings(),
+            };
+        }
+        return result;
+    }
+    /**
+     * Get the internal AST
+     */
+    getAST() {
+        return this.ast;
+    }
+    /**
+     * Create a nested builder that shares the parameter manager.
+     * This ensures parameter naming is consistent across the parent
+     * and nested sub-queries (e.g., grouped WHERE conditions).
+     *
+     * @returns A new QueryBuilderImpl that shares this builder's parameter manager
+     */
+    createNestedBuilder() {
+        return new QueryBuilderImpl({ dialect: this.dialect, debug: this.debugMode }, this.paramManager);
+    }
+    /**
+     * Clone this query builder.
+     *
+     * **⚠️ WARNING: Shared state** — The cloned builder gets a **new** parameter manager,
+     * but shares the same AST reference. Modifying the AST in either the original
+     * or the clone may affect the other. Use this for branching query variations,
+     * not for independent copies. If you need fully independent copies, compile
+     * the original first, then build a new query.
+     *
+     * @returns A new QueryBuilder with the same AST but independent parameter manager
+     */
+    clone() {
+        const cloned = new QueryBuilderImpl({
+            dialect: this.dialect,
+            debug: this.debugMode,
+        });
+        cloned.ast = this.ast;
+        return cloned;
+    }
+}
+/**
+ * Create a new query builder
+ */
+export function query(options) {
+    return new QueryBuilderImpl(options);
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/expression/builders/query-builder.js.map

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