typhex 0.1.0-alpha.0

package/dist/orm/query-builder.js

@@ -0,0 +1,433 @@
+/**
+ * Query builder: the single place where all SQL is built and executed.
+ * Provides both query (select, count) and mutation (insert, update, delete)
+ * methods. All methods that hit the database return Promises
+ * (except insert, which is synchronous to support save()).
+ */
+import { isIrOrderBy, } from "../ir/types.js";
+import { resolveWhereIr, resolveHavingIr, resolveJoinOnIr, resolveOrderBy, resolveSelectIr, resolveGroupByPaths, resolveJoinKeys, resolveUpdateSet, } from "../parser/resolve.js";
+import { RelationResolver } from "./helpers/relations/relation-resolver.js";
+import { buildFindByIdIr, pkToRecord } from "./query-helpers.js";
+import { DEFAULT_ROW_PARAM, QueryPlanBuilder, getQueryCompilerOrThrow, } from "./helpers/query-plan/query-plan.js";
+import { InsertGraphPlanner } from "./helpers/insert-graph/insert-graph-planner.js";
+import { QueryState } from "./query-state.js";
+/** C = entity; T = row shape; Ctes = registered CTE names → row types; FromKind = table vs CTE read. */
+export class QueryBuilder {
+    /** @internal */
+    static isDebugSqlEnabled = (() => {
+        const debugFlag = process?.env?.TYPHEX_DEBUG;
+        return debugFlag === "1" || debugFlag === "true" || debugFlag === "yes";
+    })();
+    /** @internal */
+    state;
+    /** @internal */
+    constructor(state) {
+        this.state = state instanceof QueryState ? state : new QueryState(state);
+    }
+    /** Return a shallow copy of this builder with mutable state (params, orderBy) deep-copied,
+     *  so chained calls do not mutate the original. */
+    clone() {
+        return new QueryBuilder(this.state.clone());
+    }
+    /** @internal — Print the SQL and parameters to stdout when TYPHEX_DEBUG is enabled. */
+    logSql(sql, params) {
+        console.log("[typhex]", sql);
+        if (params.length > 0)
+            console.log("[typhex] params:", params);
+    }
+    /** @internal */
+    buildPlan(operation) {
+        return QueryPlanBuilder.build(this.state, operation);
+    }
+    requirePkColumns(context) {
+        if (this.state.pkColumns.length === 0) {
+            throw new Error(`[typhex] ${context}: entity "${this.state.tableName}" has no primary key`);
+        }
+        return this.state.pkColumns;
+    }
+    static splitParams(params) {
+        const sqlParams = {};
+        const subqueryParams = {};
+        for (const [key, value] of Object.entries(params ?? {})) {
+            if (value instanceof QueryBuilder) {
+                subqueryParams[key] = { state: value.state };
+            }
+            else {
+                sqlParams[key] = value;
+            }
+        }
+        return { sqlParams, subqueryParams };
+    }
+    where(predicate, params) {
+        const { sqlParams, subqueryParams } = QueryBuilder.splitParams(params);
+        Object.assign(this.state.whereParams, sqlParams);
+        Object.assign(this.state.subqueryParams, subqueryParams);
+        this.state.whereIr = resolveWhereIr(predicate, params ? Object.keys(params) : [], Object.keys(subqueryParams));
+        return this;
+    }
+    orderBy(colOrIr, second = "asc") {
+        if (isIrOrderBy(colOrIr)) {
+            return this.addOrderByIr(colOrIr, typeof second === "object" ? second : null);
+        }
+        const direction = typeof second === "string" ? second : "asc";
+        return this.addOrderByInput(colOrIr, direction);
+    }
+    addOrderByIr(ir, params) {
+        this.addInlineParams(params);
+        this.state.orderBy.push(ir);
+        return this;
+    }
+    addOrderByInput(input, direction) {
+        const paramKeys = Object.keys(this.state.inlineParams ?? {});
+        this.state.orderBy.push(resolveOrderBy(input, direction, paramKeys));
+        return this;
+    }
+    addInlineParams(params) {
+        const { sqlParams, subqueryParams: captured } = QueryBuilder.splitParams(params);
+        Object.assign(this.state.subqueryParams, captured);
+        if (params !== null) {
+            this.state.inlineParams = { ...this.state.inlineParams, ...sqlParams };
+        }
+        return Object.keys(sqlParams);
+    }
+    innerJoin(keysOrFnOrEntity, onFn) {
+        return this.addJoin(keysOrFnOrEntity, onFn, "inner");
+    }
+    leftJoin(keysOrFnOrEntity, onFn) {
+        return this.addJoin(keysOrFnOrEntity, onFn, "left");
+    }
+    rightJoin(keysOrFnOrEntity, onFn) {
+        return this.addJoin(keysOrFnOrEntity, onFn, "right");
+    }
+    /** Adds a CROSS JOIN for the given relation keys or accessor function. */
+    crossJoin(keysOrFn) {
+        return this.addJoinHints(keysOrFn, "cross");
+    }
+    fullJoin(keysOrFnOrEntity, onFn) {
+        return this.addJoin(keysOrFnOrEntity, onFn, "full");
+    }
+    addJoin(keysOrFnOrEntity, onFn, joinType) {
+        if (QueryBuilder.isEntityClass(keysOrFnOrEntity)) {
+            if (!onFn) {
+                throw new Error(`${joinType}Join(entity): ON callback is required`);
+            }
+            const onIr = resolveJoinOnIr(joinType, onFn);
+            this.state.entityJoinHints = [
+                ...(this.state.entityJoinHints ?? []),
+                { joinType, entity: keysOrFnOrEntity, onIr },
+            ];
+            return this;
+        }
+        return this.addJoinHints(keysOrFnOrEntity, joinType);
+    }
+    static isEntityClass(value) {
+        if (typeof value !== "function" || value == null)
+            return false;
+        const cls = value;
+        return typeof cls.table?._table === "string";
+    }
+    addJoinHints(keysOrFn, joinType) {
+        const relationKeys = resolveJoinKeys(keysOrFn);
+        const newHints = relationKeys.map((k) => ({ relationKey: k, joinType }));
+        this.state.joinHints = [...(this.state.joinHints ?? []), ...newHints];
+        return this;
+    }
+    /** Set the maximum number of rows to return. */
+    limit(n) {
+        this.state.limitNum = n;
+        return this;
+    }
+    /** Set the number of rows to skip before returning results. */
+    offset(n) {
+        this.state.offsetNum = n;
+        return this;
+    }
+    withCte(name, subqueryOrBuild) {
+        const next = this.clone();
+        const registeredCteNames = (next.state.ctes ?? []).map((c) => c.name);
+        const inner = typeof subqueryOrBuild === "function"
+            ? subqueryOrBuild({})
+            : subqueryOrBuild;
+        const innerState = inner.state.clone();
+        if (typeof subqueryOrBuild === "function") {
+            innerState.inScopeRegisteredCteNames = registeredCteNames;
+        }
+        next.state.ctes = [...(next.state.ctes ?? []), { name, kind: "simple", inner: innerState }];
+        return next;
+    }
+    /**
+     * Register a recursive CTE: `WITH RECURSIVE name AS (<anchor> UNION ALL <recursive>)`.
+     * The body should use `.unionAll()` for the recursive step and may `.from(name)` for self-reference.
+     */
+    withRecursiveCte(name, subquery) {
+        const next = this.clone();
+        next.state.ctes = [
+            ...(next.state.ctes ?? []),
+            { name, kind: "recursive", inner: subquery.state.clone() },
+        ];
+        return next;
+    }
+    /** Append a `UNION ALL` branch to this SELECT (used for recursive CTE bodies). */
+    unionAll(other) {
+        const next = this.clone();
+        next.state.unionAll = other.state.clone();
+        return next;
+    }
+    from(source) {
+        const next = this.clone();
+        if (source === undefined) {
+            next.state.fromSource = { kind: "table" };
+            return next;
+        }
+        if (typeof source === "string") {
+            next.state.fromSource = { kind: "cte", name: source };
+            return next;
+        }
+        next.state.fromSource = { kind: "subquery", state: source.state.clone() };
+        return next;
+    }
+    select(columnsOrIr, params = null) {
+        const paramKeys = this.addInlineParams(params);
+        this.state.selectIr = resolveSelectIr(columnsOrIr, paramKeys);
+        return this;
+    }
+    /** Adds a GROUP BY clause. Accepts column names, index numbers, or an arrow function selecting group-by fields. */
+    groupBy(columnOrFn, ...rest) {
+        const entries = resolveGroupByPaths(columnOrFn, ...rest);
+        const nextSelectIr = this.state.selectIr ?? { param: DEFAULT_ROW_PARAM, paths: [] };
+        const memberPaths = entries.filter((e) => Array.isArray(e));
+        this.state.selectIr = {
+            ...nextSelectIr,
+            paths: nextSelectIr.paths.length > 0 ? nextSelectIr.paths : memberPaths,
+            groupBy: entries,
+        };
+        return this;
+    }
+    having(predicate, params) {
+        const { sqlParams, subqueryParams } = QueryBuilder.splitParams(params);
+        Object.assign(this.state.subqueryParams, subqueryParams);
+        this.state.havingIr = resolveHavingIr(predicate, params ? Object.keys(params) : [], Object.keys(subqueryParams));
+        this.state.havingParams = sqlParams;
+        return this;
+    }
+    /** Update matching rows with `set`, then re-fetch and return the updated row,
+     *  or null if no matching row is found after the update. */
+    async patch(set) {
+        await this.update(set);
+        const fresh = new QueryBuilder({
+            ...this.state,
+            orderBy: [],
+            limitNum: null,
+            offsetNum: null,
+            selectIr: null,
+            ctes: undefined,
+            fromSource: undefined,
+        });
+        return (await fresh.first()) ?? null;
+    }
+    /** Insert a single row. Awaitable directly, or chain `.onConflict(cols).doUpdate()` / `.doNothing()`. */
+    insert(row) {
+        return new InsertBuilder(this.state, row);
+    }
+    /** Insert multiple rows in one statement. Awaitable directly, or chain `.onConflict(cols).doUpdate()` / `.doNothing()`. */
+    insertMany(rows) {
+        return new InsertBuilder(this.state, rows);
+    }
+    async insertGraph(input) {
+        return new InsertGraphPlanner(this.state, input).execute();
+    }
+    /** Select single row by primary key (scalar or composite object). */
+    async findById(id) {
+        const pkCols = this.requirePkColumns("findById");
+        const row = await this.where(buildFindByIdIr(pkCols, pkToRecord(pkCols, id))).first();
+        return row ?? null;
+    }
+    /** Execute the query and return all matching rows, with relations loaded
+     *  and the hydration function applied if one is set. */
+    async toArray() {
+        const { hydrate, qe } = this.state;
+        const plan = this.buildPlan({ kind: "select" });
+        const compiler = getQueryCompilerOrThrow(this.state);
+        const { sql, params } = compiler.compilePlan(plan);
+        if (QueryBuilder.isDebugSqlEnabled)
+            this.logSql(sql, params);
+        const rows = (await qe.query(sql, params));
+        await new RelationResolver(plan, qe, rows).resolve();
+        if (!hydrate)
+            return rows;
+        return Promise.all(rows.map((r) => hydrate(r)));
+    }
+    /** Return the first matching row, or undefined if the result set is empty. */
+    async first() {
+        const arr = await this.limit(1).toArray();
+        return arr[0];
+    }
+    /** Execute a COUNT query and return rows the query would produce without limit/offset/orderBy. */
+    async count() {
+        const { qe } = this.state;
+        const compiler = getQueryCompilerOrThrow(this.state);
+        const plan = this.buildPlan({ kind: "select" });
+        const { sql, params } = compiler.compileResultSize(plan);
+        if (QueryBuilder.isDebugSqlEnabled)
+            this.logSql(sql, params);
+        const rows = (await qe.query(sql, params));
+        return Number(rows[0]?.c ?? 0);
+    }
+    async update(setOrFn) {
+        const resolved = resolveUpdateSet(setOrFn);
+        this.state.updateSetIr = resolved.setIr;
+        const { qe } = this.state;
+        const compiler = getQueryCompilerOrThrow(this.state);
+        const { sql, params } = compiler.compilePlan(this.buildPlan({ kind: "update", ...resolved }));
+        if (!sql)
+            return 0;
+        if (QueryBuilder.isDebugSqlEnabled)
+            this.logSql(sql, params);
+        const result = await qe.run(sql, params);
+        return result.changes;
+    }
+    async updateReturning(setOrFn) {
+        const resolved = resolveUpdateSet(setOrFn);
+        this.state.updateSetIr = resolved.setIr;
+        const { qe, hydrate } = this.state;
+        const compiler = getQueryCompilerOrThrow(this.state);
+        const { sql, params } = compiler.compilePlan(this.buildPlan({ kind: "update", ...resolved, returning: true }));
+        if (!sql)
+            return [];
+        if (QueryBuilder.isDebugSqlEnabled)
+            this.logSql(sql, params);
+        const rows = (await qe.query(sql, params));
+        if (!hydrate)
+            return rows;
+        return Promise.all(rows.map((r) => hydrate(r)));
+    }
+    /** Execute a DELETE for the current WHERE clause and return the number of affected rows. */
+    async delete() {
+        const { qe } = this.state;
+        const compiler = getQueryCompilerOrThrow(this.state);
+        const { sql, params } = compiler.compilePlan(this.buildPlan({ kind: "delete" }));
+        if (QueryBuilder.isDebugSqlEnabled)
+            this.logSql(sql, params);
+        const result = await qe.run(sql, params);
+        return result.changes;
+    }
+    /** DELETE ... RETURNING * (when supported). */
+    async deleteReturning() {
+        const { qe, hydrate } = this.state;
+        const compiler = getQueryCompilerOrThrow(this.state);
+        const { sql, params } = compiler.compilePlan(this.buildPlan({ kind: "delete", returning: true }));
+        if (QueryBuilder.isDebugSqlEnabled)
+            this.logSql(sql, params);
+        const rows = (await qe.query(sql, params));
+        if (!hydrate)
+            return rows;
+        return Promise.all(rows.map((r) => hydrate(r)));
+    }
+}
+/**
+ * Deferred insert returned by `insert()` / `insertMany()`.
+ * Extends `QueryBuilder` so it owns its execution logic and has direct access to state.
+ * Awaitable directly (no conflict handling) or chain `.onConflict(cols).doUpdate()` / `.doNothing()`.
+ *
+ * @example
+ * await qb.insert(row);
+ * await qb.insert(row).onConflict(["sku"]).doUpdate();
+ * await qb.insertMany(rows).onConflict(["sku"]).doNothing();
+ */
+export class InsertBuilder extends QueryBuilder {
+    _conflictCols;
+    _payload;
+    /** @internal */
+    constructor(state, payload) {
+        super(state);
+        this._payload = payload;
+    }
+    /** Store the conflict target columns; returns `this` for chaining. */
+    onConflict(columns) {
+        this._conflictCols = columns;
+        return this;
+    }
+    /** `ON CONFLICT (...) DO UPDATE SET ...` — executes the insert. */
+    doUpdate(updateColumns) {
+        return this._execute({ conflictColumns: this._conflictCols, action: "update", updateColumns });
+    }
+    /** `ON CONFLICT (...) DO NOTHING` — executes the insert. */
+    doNothing() {
+        return this._execute({ conflictColumns: this._conflictCols, action: "nothing" });
+    }
+    /** PromiseLike: allows `await insert(row)` without a conflict clause. */
+    then(res, rej) {
+        return this._execute().then(res, rej);
+    }
+    _execute(onConflict) {
+        return (Array.isArray(this._payload)
+            ? this._doInsertMany(this._payload, onConflict)
+            : this._doInsert(this._payload, onConflict));
+    }
+    async _doInsert(row, onConflict) {
+        const { columnNames, qe, hydrate } = this.state;
+        const compiler = getQueryCompilerOrThrow(this.state);
+        const cols = columnNames.filter((c) => row[c] !== undefined);
+        const params = cols.map((c) => row[c]);
+        const pkCols = this.state.pkColumns;
+        this.state.insertIr = undefined;
+        const compiled = compiler.compilePlan(this.buildPlan({
+            kind: "insert",
+            columns: cols,
+            values: params,
+            pk: pkCols,
+            onConflict,
+        }));
+        if (QueryBuilder.isDebugSqlEnabled)
+            this.logSql(compiled.sql, compiled.params);
+        if (compiled.returningRow) {
+            const rows = (await qe.query(compiled.sql, compiled.params));
+            const raw = rows[0];
+            if (raw == null)
+                throw new Error("insert: RETURNING returned no row");
+            if (hydrate)
+                return (await hydrate(raw));
+            return raw;
+        }
+        const result = await qe.run(compiled.sql, compiled.params);
+        if (pkCols.length === 0)
+            return undefined;
+        // For single auto-increment PKs use lastID; for composite PKs all values are in `row`.
+        const pkRow = pkCols.length === 1 && result.lastID != null ? { ...row, [pkCols[0]]: result.lastID } : row;
+        const whereIr = buildFindByIdIr(pkCols, pkRow);
+        const inst = await this.clone().where(whereIr).first();
+        if (!inst)
+            throw new Error("insert: insert succeeded but row not found");
+        return inst;
+    }
+    async _doInsertMany(rows, onConflict) {
+        if (rows.length === 0)
+            return [];
+        const { columnNames, qe, hydrate } = this.state;
+        const compiler = getQueryCompilerOrThrow(this.state);
+        const pkCols = this.state.pkColumns;
+        // Collect columns in entity-defined order, keeping any column present in at least one row.
+        const cols = columnNames.filter((c) => rows.some((r) => r[c] !== undefined));
+        const paramRows = rows.map((r) => cols.map((c) => r[c] ?? null));
+        this.state.insertIr = undefined;
+        const compiled = compiler.compilePlan(this.buildPlan({
+            kind: "insertMany",
+            columns: cols,
+            rows: paramRows,
+            pk: pkCols,
+            onConflict,
+        }));
+        if (QueryBuilder.isDebugSqlEnabled)
+            this.logSql(compiled.sql, compiled.params);
+        if (compiled.returningRow) {
+            const returned = (await qe.query(compiled.sql, compiled.params));
+            const hydratedRows = [];
+            for (const raw of returned)
+                hydratedRows.push(hydrate ? (await hydrate(raw)) : raw);
+            return hydratedRows;
+        }
+        await qe.run(compiled.sql, compiled.params);
+        return [];
+    }
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/orm/query-builder.js.map

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

package/dist/orm/query-helpers.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Internal helpers for building IR. Not exported from public API.
+ * Used by Entity and other internal modules.
+ */
+import type { IrWhere } from "../ir/types.js";
+/** Build IR for: column === value. Used for PK lookups, etc. */
+export declare function whereColumnEq(column: string, value: unknown, param?: string): IrWhere;
+/** Build IR for: column IN array. Used for batch relation loading. */
+export declare function whereColumnIn(column: string, values: unknown[], param?: string): IrWhere;
+/** Combine two IR nodes with AND. Used when relation has both base filter and user where. */
+export declare function whereAnd(left: IrWhere, right: IrWhere): IrWhere;
+/** Serialize a row's values for the given columns into a stable string key.
+ *  Used for composite-key grouping/lookup when columns > 1. */
+export declare function makeCompositeKey(row: Record<string, unknown>, cols: string[]): string;
+/**
+ * Build a WHERE IR that filters rows by a set of columns using AND-of-INs.
+ *   Single column:   WHERE tgtCol IN (v1, v2, ...)
+ *   Multiple columns: WHERE tgtCol1 IN (v1a, v1b) AND tgtCol2 IN (v2a, v2b) AND ...
+ *
+ * Collects distinct non-null values for each srcCol from `rows` and compares
+ * them against the corresponding tgtCol in the target query. The result is the
+ * cross-product of distinct values per column — a superset of the exact matches.
+ * The in-memory grouping step (groupByCompositeKey / indexByCompositeKey)
+ * corrects any over-fetch.
+ *
+ * Returns null when any column produces an empty value set (nothing to fetch).
+ */
+export declare function buildRelationFetchWhereIr(rows: Record<string, unknown>[], srcCols: string[], tgtCols: string[]): IrWhere | null;
+/** Build WHERE IR for a primary key match. Accepts a Record keyed by PK column names
+ *  (entity instance, composite id object, or the result of `pkToRecord`). */
+export declare function buildFindByIdIr(pkColumns: string[], id: Record<string, unknown>): IrWhere;
+/** Normalise a user-supplied PK value to a Record.
+ *  Scalar values (e.g. `5`) are wrapped as `{ [col]: value }` for single-column PKs. */
+export declare function pkToRecord(pkColumns: string[], id: unknown): Record<string, unknown>;
+//# sourceMappingURL=query-helpers.d.ts.map

package/dist/orm/query-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-helpers.d.ts","sourceRoot":"","sources":["../../src/orm/query-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAU,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAKtD,gEAAgE;AAChE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,SAAoB,GAAG,OAAO,CAEhG;AAWD,sEAAsE;AACtE,wBAAgB,aAAa,CAC3B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,OAAO,EAAE,EACjB,KAAK,SAAoB,GACxB,OAAO,CAET;AAUD,6FAA6F;AAC7F,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAK/D;AAED;+DAC+D;AAC/D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAErF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,MAAM,EAAE,GAChB,OAAO,GAAG,IAAI,CAShB;AAED;6EAC6E;AAC7E,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAMzF;AAMD;wFACwF;AACxF,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEpF"}

package/dist/orm/query-helpers.js

@@ -0,0 +1,83 @@
+/**
+ * Internal helpers for building IR. Not exported from public API.
+ * Used by Entity and other internal modules.
+ */
+import { isRecord } from "../utils.js";
+const DEFAULT_ROW_PARAM = "u";
+/** Build IR for: column === value. Used for PK lookups, etc. */
+export function whereColumnEq(column, value, param = DEFAULT_ROW_PARAM) {
+    return toWhere(columnEqNode(column, value, param), param);
+}
+function columnEqNode(column, value, param = DEFAULT_ROW_PARAM) {
+    return {
+        kind: "binary",
+        op: "===",
+        left: { kind: "member", param, path: [column] },
+        right: { kind: "const", value },
+    };
+}
+/** Build IR for: column IN array. Used for batch relation loading. */
+export function whereColumnIn(column, values, param = DEFAULT_ROW_PARAM) {
+    return toWhere(columnInNode(column, values, param), param);
+}
+function columnInNode(column, values, param = DEFAULT_ROW_PARAM) {
+    return {
+        kind: "in",
+        left: { kind: "member", param, path: [column] },
+        right: { kind: "const", value: values },
+    };
+}
+/** Combine two IR nodes with AND. Used when relation has both base filter and user where. */
+export function whereAnd(left, right) {
+    return toWhere({ kind: "binary", op: "&&", left: left.node, right: right.node }, left.rootParam, [
+        ...(left.localParamNames ?? [left.rootParam]),
+        ...(right.localParamNames ?? [right.rootParam]),
+    ]);
+}
+/** Serialize a row's values for the given columns into a stable string key.
+ *  Used for composite-key grouping/lookup when columns > 1. */
+export function makeCompositeKey(row, cols) {
+    return cols.map((c) => JSON.stringify(row[c] ?? null)).join("\x00");
+}
+/**
+ * Build a WHERE IR that filters rows by a set of columns using AND-of-INs.
+ *   Single column:   WHERE tgtCol IN (v1, v2, ...)
+ *   Multiple columns: WHERE tgtCol1 IN (v1a, v1b) AND tgtCol2 IN (v2a, v2b) AND ...
+ *
+ * Collects distinct non-null values for each srcCol from `rows` and compares
+ * them against the corresponding tgtCol in the target query. The result is the
+ * cross-product of distinct values per column — a superset of the exact matches.
+ * The in-memory grouping step (groupByCompositeKey / indexByCompositeKey)
+ * corrects any over-fetch.
+ *
+ * Returns null when any column produces an empty value set (nothing to fetch).
+ */
+export function buildRelationFetchWhereIr(rows, srcCols, tgtCols) {
+    let where = null;
+    for (let i = 0; i < tgtCols.length; i++) {
+        const vals = [...new Set(rows.map((r) => r[srcCols[i]]).filter((v) => v != null))];
+        if (vals.length === 0)
+            return null;
+        const clause = whereColumnIn(tgtCols[i], vals);
+        where = where ? whereAnd(where, clause) : clause;
+    }
+    return where;
+}
+/** Build WHERE IR for a primary key match. Accepts a Record keyed by PK column names
+ *  (entity instance, composite id object, or the result of `pkToRecord`). */
+export function buildFindByIdIr(pkColumns, id) {
+    let node = whereColumnEq(pkColumns[0], id[pkColumns[0]]);
+    for (let i = 1; i < pkColumns.length; i++) {
+        node = whereAnd(node, whereColumnEq(pkColumns[i], id[pkColumns[i]]));
+    }
+    return node;
+}
+function toWhere(node, rootParam, localParamNames = [rootParam]) {
+    return { node, rootParam, localParamNames: [...new Set(localParamNames)] };
+}
+/** Normalise a user-supplied PK value to a Record.
+ *  Scalar values (e.g. `5`) are wrapped as `{ [col]: value }` for single-column PKs. */
+export function pkToRecord(pkColumns, id) {
+    return isRecord(id) ? id : { [pkColumns[0]]: id };
+}
+//# sourceMappingURL=query-helpers.js.map

package/dist/orm/query-helpers.js.map

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

package/dist/orm/query-state.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Shared query-builder state and cloning helpers.
+ */
+import type { WithClause } from "../dbs/types.js";
+import type { IrHaving, IrNode, IrOrderBy, IrSelect, IrWhere, EntityJoinHint, JoinHint } from "../ir/types.js";
+import type { AnyEntityClass } from "../entity/entity.js";
+import type { RelationsMap, RelationDef } from "../entity/relations.js";
+import type { QueryExecutor } from "./db.js";
+export type FromSource = {
+    kind: "table";
+} | {
+    kind: "cte";
+    name: string;
+} | {
+    kind: "subquery";
+    state: QueryState<unknown>;
+};
+/** Fields required to construct a {@link QueryState}. */
+export interface QueryStateInit<T = unknown> {
+    tableName: string;
+    columnNames: string[];
+    qe: QueryExecutor;
+    pkColumns: string[];
+    whereIr: IrWhere | null;
+    whereParams: Record<string, unknown>;
+    subqueryParams: Record<string, CapturedSubquery>;
+    orderBy: IrOrderBy[];
+    limitNum: number | null;
+    offsetNum: number | null;
+    selectIr: IrSelect | null;
+    inlineParams?: Record<string, unknown>;
+    relations?: RelationsMap;
+    hydrate?: (row: Record<string, unknown>) => T | Promise<T>;
+    resolveRelationTarget?: (rel: RelationDef) => {
+        table: string;
+        pk: string[];
+        schema: Record<string, string>;
+    } | null;
+    joinHints?: JoinHint[];
+    /** JOIN to entity tables with custom ON (e.g. recursive CTE self-join). */
+    entityJoinHints?: EntityJoinHint[];
+    havingIr: IrHaving | null;
+    havingParams: Record<string, unknown>;
+    entity?: AnyEntityClass;
+    /** UNION ALL branch appended to this SELECT (anchor.unionAll(recursive)). */
+    unionAll?: QueryState<unknown>;
+    ctes?: WithClause[];
+    /** Registered sibling CTE names in scope (bodies built via `withCte` callback). */
+    inScopeRegisteredCteNames?: string[];
+    fromSource?: FromSource | null;
+    /** Parsed SET column IR for UPDATE (set before plan; not cloned by default). */
+    updateSetIr?: Record<string, IrNode>;
+    /** Parsed VALUES column IR for INSERT / upsert (reserved; set before plan when supported). */
+    insertIr?: Record<string, IrNode>;
+}
+//# sourceMappingURL=query-state.d.ts.map

package/dist/orm/query-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-state.d.ts","sourceRoot":"","sources":["../../src/orm/query-state.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EACV,QAAQ,EACR,MAAM,EACN,SAAS,EACT,QAAQ,EACR,OAAO,EACP,cAAc,EACd,QAAQ,EACT,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAO7C,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAErD,yDAAyD;AACzD,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,EAAE,EAAE,aAAa,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACjD,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,YAAY,CAAC;IACzB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3D,qBAAqB,CAAC,EAAE,CACtB,GAAG,EAAE,WAAW,KACb;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5E,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IACpB,mFAAmF;IACnF,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC;IACrC,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC"}