linkgress-orm 0.4.36 → 0.4.38

package/dist/query/cte-builder.js

@@ -57,19 +57,43 @@ class DbCteBuilder {
             paramCounter: this.paramOffset,
             params: [],
         };
-        // Build the CTE query and get selection metadata
-        const mockRow = query._createMockRow();
-        const selectionResult = query.selector(mockRow);
-        const sql = query.buildQuery(selectionResult, {
+        const queryContext = {
             ctes: new Map(),
             cteCounter: 0,
             paramCounter: context.paramCounter,
             allParams: context.params,
-        }).sql;
+        };
+        let sql;
+        let selectionResult;
+        // Grouped query builders (`.groupBy(...).select(...)`, possibly with a
+        // trailing `.leftJoin(...)`) render their body — including SUM/COUNT/MIN/MAX
+        // aggregates and the GROUP BY — through `buildCteQuery`. They do NOT expose
+        // `_createMockRow`/`selector`, so detect and handle them first. Column
+        // definitions / mappers come from `getSelectionMetadata`. This lets an
+        // aggregate query be used as a *plain* CTE (one row per group), distinct
+        // from `withAggregation` which folds the whole group into a json_agg array.
+        if (typeof query.buildCteQuery === 'function') {
+            const result = query.buildCteQuery(queryContext);
+            sql = result.sql;
+            selectionResult = typeof query.getSelectionMetadata === 'function'
+                ? query.getSelectionMetadata()
+                : {};
+        }
+        else {
+            // Standard SelectQueryBuilder — render via mock row + selector.
+            const mockRow = query._createMockRow();
+            selectionResult = query.selector(mockRow);
+            sql = query.buildQuery(selectionResult, queryContext).sql;
+        }
         // Update parameter offset for next CTE
-        this.paramOffset = context.paramCounter;
+        this.paramOffset = queryContext.paramCounter;
         // Create column definitions from the selection
         const columnDefs = {};
+        if (selectionResult) {
+            for (const key of Object.keys(selectionResult)) {
+                columnDefs[key] = key;
+            }
+        }
         const cte = new DbCte(cteName, sql, context.params, columnDefs, selectionResult);
         this.ctes.push(cte);
         return { cte };

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

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

package/dist/query/cte-root-query.d.ts

@@ -0,0 +1,164 @@
+import type { DatabaseClient } from '../database/database-client.interface';
+import { QueryExecutor } from '../entity/db-context';
+import type { OrderDirection } from '../entity/db-context';
+import { Condition, UnwrapSelection } from './conditions';
+import { DbCte } from './cte-builder';
+/**
+ * Join types supported when a CTE is the FROM root.
+ *
+ * Unlike the entity-anchored {@link JoinQueryBuilder} (which only models
+ * `INNER`/`LEFT`), a CTE-rooted query can express the full set of SQL join
+ * flavours — including `FULL OUTER` and `CROSS` — because both sides are
+ * already materialized, independent relations (the CTE bodies). This is what
+ * makes a `spend FULL OUTER JOIN current_tier ON TRUE` shape expressible.
+ */
+export type CteJoinType = 'INNER' | 'LEFT' | 'RIGHT' | 'FULL OUTER' | 'CROSS';
+/**
+ * A constant `TRUE` join predicate, for cross-product joins written as
+ * `… JOIN … ON TRUE`. Equivalent to a `CROSS JOIN` but keeps the `ON`
+ * keyword, which Postgres requires for `FULL OUTER JOIN` (a bare
+ * `FULL OUTER JOIN` with no `ON`/`USING` is a syntax error).
+ *
+ * @example
+ * cteBuilder
+ *   .selectFromCte(spendCte)
+ *   .fullOuterJoin(currentTierCte, onTrue(), (s, t) => ({ ... }))
+ */
+export declare function onTrue(): Condition;
+/**
+ * A single joined CTE step (the right-hand relation + how it is attached).
+ */
+interface CteJoinStep {
+    type: CteJoinType;
+    cte: DbCte<any>;
+    /** ON predicate. Always undefined for `CROSS` joins. */
+    condition?: Condition;
+}
+/**
+ * A query whose FROM root is a {@link DbCte} (rather than an entity table),
+ * joined to one or more further CTEs with any SQL join flavour.
+ *
+ * This complements the entity-anchored `db.<table>.with(...).leftJoin(cte, …)`
+ * path: there the FROM root must be a real table and joins are `INNER`/`LEFT`
+ * only. Here the FROM root is itself a CTE and `FULL OUTER` / `RIGHT` / `CROSS`
+ * joins (and `ON TRUE` predicates) are available — exactly what a
+ * `WITH a AS (…), b AS (…) SELECT … FROM a FULL OUTER JOIN b ON TRUE` shape
+ * needs.
+ *
+ * Parameter ordering: every CTE body's parameters are emitted first, in `WITH`
+ * declaration order (root CTE, then each joined CTE), followed by any `ON`
+ * predicate parameters — so the whole statement keeps a single, sequential
+ * `$1..$n` numbering, matching how the entity-rooted CTE path orders params.
+ *
+ * @typeParam TRootColumns - the column shape of the root CTE
+ * @typeParam TSelection - the projected output row shape (after `.select(...)`)
+ */
+export declare class CteRootQueryBuilder<TRootColumns extends Record<string, any>, TSelection = TRootColumns> {
+    protected rootCte: DbCte<TRootColumns>;
+    protected client: DatabaseClient;
+    protected executor?: QueryExecutor | undefined;
+    private joinSteps;
+    private selector?;
+    private orderByFields;
+    private limitValue?;
+    private offsetValue?;
+    constructor(rootCte: DbCte<TRootColumns>, client: DatabaseClient, executor?: QueryExecutor | undefined);
+    /** Override the per-query timeout (ms). Pass `0` to disable. */
+    withTimeout(timeoutMs: number): this;
+    /** Flag this query as expected to finish within `expectedMs` (ms). */
+    expectedExecutionTime(expectedMs: number): this;
+    /**
+     * `INNER JOIN` another CTE.
+     */
+    innerJoin<TRight extends Record<string, any>>(cte: DbCte<TRight>, condition: Condition): CteJoinedQueryBuilder<TRootColumns, TRight>;
+    /**
+     * `LEFT JOIN` another CTE.
+     */
+    leftJoin<TRight extends Record<string, any>>(cte: DbCte<TRight>, condition: Condition): CteJoinedQueryBuilder<TRootColumns, TRight>;
+    /**
+     * `RIGHT JOIN` another CTE.
+     */
+    rightJoin<TRight extends Record<string, any>>(cte: DbCte<TRight>, condition: Condition): CteJoinedQueryBuilder<TRootColumns, TRight>;
+    /**
+     * `FULL OUTER JOIN` another CTE.
+     *
+     * Postgres requires an `ON`/`USING` clause on a `FULL OUTER JOIN`, so pass a
+     * predicate — use {@link onTrue} for the cross-product (`ON TRUE`) form that
+     * keeps every row of both sides while pairing them up.
+     */
+    fullOuterJoin<TRight extends Record<string, any>>(cte: DbCte<TRight>, condition: Condition): CteJoinedQueryBuilder<TRootColumns, TRight>;
+    /**
+     * `CROSS JOIN` another CTE (cartesian product, no `ON`).
+     */
+    crossJoin<TRight extends Record<string, any>>(cte: DbCte<TRight>): CteJoinedQueryBuilder<TRootColumns, TRight>;
+    /**
+     * Project the root CTE's columns directly (no join).
+     */
+    select<TNewSelection>(selector: (root: TRootColumns) => TNewSelection): CteRootQueryBuilder<TRootColumns, UnwrapSelection<TNewSelection>>;
+    /**
+     * Order the result. Selector returns one or more projected columns (by their
+     * output alias) — `ORDER BY "alias"` — supporting the same shapes as the
+     * other builders (`r => r.col`, `r => [a, b]`, `r => [[a, 'DESC']]`).
+     */
+    orderBy<T>(selector: (row: TSelection) => T): this;
+    orderBy<T>(selector: (row: TSelection) => T[]): this;
+    orderBy<T>(selector: (row: TSelection) => Array<[T, OrderDirection]>): this;
+    /** Limit the result set. */
+    limit(count: number): this;
+    /** Offset the result set. */
+    offset(count: number): this;
+    private addJoin;
+    /** @internal — used by the joined builder to share the build machinery. */
+    _getRootCte(): DbCte<TRootColumns>;
+    /** @internal */
+    _setState(joinSteps: CteJoinStep[], selector: ((...sources: any[]) => any) | undefined, orderByFields: Array<{
+        table: string;
+        field: string;
+        direction: 'ASC' | 'DESC';
+    }>, limitValue: number | undefined, offsetValue: number | undefined): void;
+    /**
+     * Build the SQL + ordered parameter array for this CTE-rooted query.
+     * @internal
+     */
+    buildQuery(): {
+        sql: string;
+        params: any[];
+    };
+    /** Generate the SQL string (for debugging / assertions). */
+    toSql(): string;
+    /** Execute and return all rows. */
+    toList(): Promise<TSelection[]>;
+    /** Execute and return the first row, or null. */
+    first(): Promise<TSelection | null>;
+    /** Evaluate the user selector against fresh CTE FieldRef proxies. */
+    protected evaluateSelection(): Record<string, any>;
+}
+/**
+ * The result of joining a CTE onto a CTE-rooted query. Carries the same build
+ * machinery as {@link CteRootQueryBuilder} but its `.select(...)` selector
+ * receives a FieldRef proxy per source (root first, then each joined CTE in
+ * order), and further joins can still be chained.
+ */
+export declare class CteJoinedQueryBuilder<TRootColumns extends Record<string, any>, TRight extends Record<string, any>, TSelection = TRootColumns & TRight> extends CteRootQueryBuilder<TRootColumns, TSelection> {
+    private _joinSteps;
+    /** @internal */
+    _inheritJoins(steps: CteJoinStep[]): void;
+    /**
+     * Project columns from the root CTE plus every joined CTE. The selector is
+     * called with `(root, ...joined)` FieldRef proxies in FROM declaration order.
+     *
+     * The common single-join case is fully typed: `(root, right)` where `right`
+     * is the joined CTE ({@link TRight}). For 3+ way joins, the additional joined
+     * sources arrive (in FROM order) as loosely-typed rest arguments.
+     */
+    select<TNewSelection>(selector: (root: TRootColumns, right: TRight) => TNewSelection): CteRootQueryBuilder<TRootColumns, UnwrapSelection<TNewSelection>>;
+    select<TNewSelection>(selector: (root: TRootColumns, ...joined: any[]) => TNewSelection): CteRootQueryBuilder<TRootColumns, UnwrapSelection<TNewSelection>>;
+    /**
+     * Typed `fullOuterJoin` that exposes both already-joined sources (root +
+     * first right) to the predicate. (Re-declared so the chained right side keeps
+     * a useful element type rather than collapsing to the base signature.)
+     */
+    fullOuterJoin<TThird extends Record<string, any>>(cte: DbCte<TThird>, condition: Condition): CteJoinedQueryBuilder<TRootColumns, TThird>;
+}
+export {};
+//# sourceMappingURL=cte-root-query.d.ts.map

package/dist/query/cte-root-query.d.ts.map

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

package/dist/query/cte-root-query.js

@@ -0,0 +1,398 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CteJoinedQueryBuilder = exports.CteRootQueryBuilder = void 0;
+exports.onTrue = onTrue;
+const db_context_1 = require("../entity/db-context");
+const conditions_1 = require("./conditions");
+const query_utils_1 = require("./query-utils");
+/** SQL keyword emitted for each {@link CteJoinType}. */
+const CTE_JOIN_SQL = {
+    INNER: 'INNER JOIN',
+    LEFT: 'LEFT JOIN',
+    RIGHT: 'RIGHT JOIN',
+    'FULL OUTER': 'FULL OUTER JOIN',
+    CROSS: 'CROSS JOIN',
+};
+/**
+ * A constant `TRUE` join predicate, for cross-product joins written as
+ * `… JOIN … ON TRUE`. Equivalent to a `CROSS JOIN` but keeps the `ON`
+ * keyword, which Postgres requires for `FULL OUTER JOIN` (a bare
+ * `FULL OUTER JOIN` with no `ON`/`USING` is a syntax error).
+ *
+ * @example
+ * cteBuilder
+ *   .selectFromCte(spendCte)
+ *   .fullOuterJoin(currentTierCte, onTrue(), (s, t) => ({ ... }))
+ */
+function onTrue() {
+    return (0, conditions_1.sql) `TRUE`;
+}
+/**
+ * Build a mock row that yields {@link FieldRef}s for a CTE's columns, qualified
+ * with the CTE's own name as the table alias. Mirrors
+ * `SelectQueryBuilder.createMockRowForCte` so column mappers / aggregation-array
+ * markers carried on the CTE's `selectionMetadata` survive into the projection.
+ */
+function createCteFieldRefProxy(cte) {
+    return new Proxy({}, {
+        get(_target, prop) {
+            if (typeof prop === 'symbol') {
+                return undefined;
+            }
+            if (cte.selectionMetadata && prop in cte.selectionMetadata) {
+                const value = cte.selectionMetadata[prop];
+                // SqlFragment / column with a fromDriver mapper — preserve it so the
+                // projection re-applies the mapper to the joined column.
+                if (typeof value === 'object' && value !== null && typeof value.getMapper === 'function') {
+                    return {
+                        __fieldName: prop,
+                        __dbColumnName: prop,
+                        __tableAlias: cte.name,
+                        getMapper: () => value.getMapper(),
+                    };
+                }
+                // CTE aggregation-array marker (json_agg column) — preserve the inner
+                // metadata so nested items can be mapped.
+                if (typeof value === 'object' && value !== null && '__isAggregationArray' in value && value.__isAggregationArray) {
+                    return {
+                        __fieldName: prop,
+                        __dbColumnName: prop,
+                        __tableAlias: cte.name,
+                        __isAggregationArray: true,
+                        __innerSelectionMetadata: value.__innerSelectionMetadata,
+                    };
+                }
+            }
+            return {
+                __fieldName: prop,
+                __dbColumnName: prop,
+                __tableAlias: cte.name,
+            };
+        },
+        has() {
+            return true;
+        },
+        ownKeys() {
+            return cte.columnDefs ? Object.keys(cte.columnDefs) : [];
+        },
+        getOwnPropertyDescriptor() {
+            return { enumerable: true, configurable: true };
+        },
+    });
+}
+const NUMERIC_REGEX = /^-?\d+(\.\d+)?$/;
+/**
+ * A query whose FROM root is a {@link DbCte} (rather than an entity table),
+ * joined to one or more further CTEs with any SQL join flavour.
+ *
+ * This complements the entity-anchored `db.<table>.with(...).leftJoin(cte, …)`
+ * path: there the FROM root must be a real table and joins are `INNER`/`LEFT`
+ * only. Here the FROM root is itself a CTE and `FULL OUTER` / `RIGHT` / `CROSS`
+ * joins (and `ON TRUE` predicates) are available — exactly what a
+ * `WITH a AS (…), b AS (…) SELECT … FROM a FULL OUTER JOIN b ON TRUE` shape
+ * needs.
+ *
+ * Parameter ordering: every CTE body's parameters are emitted first, in `WITH`
+ * declaration order (root CTE, then each joined CTE), followed by any `ON`
+ * predicate parameters — so the whole statement keeps a single, sequential
+ * `$1..$n` numbering, matching how the entity-rooted CTE path orders params.
+ *
+ * @typeParam TRootColumns - the column shape of the root CTE
+ * @typeParam TSelection - the projected output row shape (after `.select(...)`)
+ */
+class CteRootQueryBuilder {
+    constructor(rootCte, client, executor) {
+        this.rootCte = rootCte;
+        this.client = client;
+        this.executor = executor;
+        this.joinSteps = [];
+        this.orderByFields = [];
+    }
+    /** Override the per-query timeout (ms). Pass `0` to disable. */
+    withTimeout(timeoutMs) {
+        this.executor = this.executor
+            ? this.executor.withTimeout(timeoutMs)
+            : new db_context_1.QueryExecutor(this.client, undefined, timeoutMs);
+        return this;
+    }
+    /** Flag this query as expected to finish within `expectedMs` (ms). */
+    expectedExecutionTime(expectedMs) {
+        this.executor = this.executor
+            ? this.executor.withExpectedExecutionTime(expectedMs)
+            : new db_context_1.QueryExecutor(this.client, undefined, undefined, expectedMs);
+        return this;
+    }
+    /**
+     * `INNER JOIN` another CTE.
+     */
+    innerJoin(cte, condition) {
+        return this.addJoin('INNER', cte, condition);
+    }
+    /**
+     * `LEFT JOIN` another CTE.
+     */
+    leftJoin(cte, condition) {
+        return this.addJoin('LEFT', cte, condition);
+    }
+    /**
+     * `RIGHT JOIN` another CTE.
+     */
+    rightJoin(cte, condition) {
+        return this.addJoin('RIGHT', cte, condition);
+    }
+    /**
+     * `FULL OUTER JOIN` another CTE.
+     *
+     * Postgres requires an `ON`/`USING` clause on a `FULL OUTER JOIN`, so pass a
+     * predicate — use {@link onTrue} for the cross-product (`ON TRUE`) form that
+     * keeps every row of both sides while pairing them up.
+     */
+    fullOuterJoin(cte, condition) {
+        return this.addJoin('FULL OUTER', cte, condition);
+    }
+    /**
+     * `CROSS JOIN` another CTE (cartesian product, no `ON`).
+     */
+    crossJoin(cte) {
+        return this.addJoin('CROSS', cte, undefined);
+    }
+    /**
+     * Project the root CTE's columns directly (no join).
+     */
+    select(selector) {
+        const next = new CteRootQueryBuilder(this.rootCte, this.client, this.executor);
+        next.joinSteps = this.joinSteps;
+        next.selector = selector;
+        next.orderByFields = this.orderByFields;
+        next.limitValue = this.limitValue;
+        next.offsetValue = this.offsetValue;
+        return next;
+    }
+    orderBy(selector) {
+        const mockRow = new Proxy({}, {
+            get: (_t, prop) => {
+                if (typeof prop === 'symbol') {
+                    return undefined;
+                }
+                return { __fieldName: prop, __dbColumnName: prop };
+            },
+            has: () => true,
+        });
+        const result = selector(mockRow);
+        this.orderByFields = [];
+        (0, query_utils_1.parseOrderBy)(result, this.orderByFields, undefined, () => '');
+        return this;
+    }
+    /** Limit the result set. */
+    limit(count) {
+        this.limitValue = count;
+        return this;
+    }
+    /** Offset the result set. */
+    offset(count) {
+        this.offsetValue = count;
+        return this;
+    }
+    addJoin(type, cte, condition) {
+        const next = new CteJoinedQueryBuilder(this.rootCte, this.client, this.executor);
+        next._inheritJoins([...this.joinSteps, { type, cte, condition }]);
+        return next;
+    }
+    /** @internal — used by the joined builder to share the build machinery. */
+    _getRootCte() {
+        return this.rootCte;
+    }
+    /** @internal */
+    _setState(joinSteps, selector, orderByFields, limitValue, offsetValue) {
+        this.joinSteps = joinSteps;
+        this.selector = selector;
+        this.orderByFields = orderByFields;
+        this.limitValue = limitValue;
+        this.offsetValue = offsetValue;
+    }
+    /**
+     * Build the SQL + ordered parameter array for this CTE-rooted query.
+     * @internal
+     */
+    buildQuery() {
+        if (!this.selector) {
+            throw new Error('A selection is required. Call .select(...) before executing a CTE-rooted query.');
+        }
+        const params = [];
+        // Parameters of every CTE body come first, in WITH declaration order
+        // (root, then each join). The bodies already carry sequential `$N`
+        // placeholders assigned by DbCteBuilder, so just concatenate their params.
+        params.push(...this.rootCte.params);
+        for (const step of this.joinSteps) {
+            params.push(...step.cte.params);
+        }
+        // The ON predicates are appended after all CTE-body params. Their next free
+        // placeholder index is therefore (paramsSoFar + 1).
+        const ctx = {
+            paramCounter: params.length + 1,
+            params,
+        };
+        // FROM root
+        let fromClause = `FROM "${this.rootCte.name}"`;
+        for (const step of this.joinSteps) {
+            const keyword = CTE_JOIN_SQL[step.type];
+            if (step.type === 'CROSS') {
+                fromClause += `\n${keyword} "${step.cte.name}"`;
+            }
+            else {
+                const condBuilder = new conditions_1.ConditionBuilder();
+                const { sql: condSql, params: condParams, paramCounter } = condBuilder.build(step.condition, ctx.paramCounter);
+                ctx.paramCounter = paramCounter;
+                ctx.params.push(...condParams);
+                fromClause += `\n${keyword} "${step.cte.name}" ON ${condSql}`;
+            }
+        }
+        // Build the WITH clause from every referenced CTE, in declaration order.
+        const cteDecls = [`"${this.rootCte.name}" AS (${this.rootCte.query})`];
+        for (const step of this.joinSteps) {
+            cteDecls.push(`"${step.cte.name}" AS (${step.cte.query})`);
+        }
+        // Build SELECT from the projection (root + joined CTE FieldRefs).
+        const selection = this.evaluateSelection();
+        const selectParts = buildSelectParts(selection, ctx, this.rootCte.name);
+        let orderByClause = '';
+        if (this.orderByFields.length > 0) {
+            const orderParts = this.orderByFields.map(({ field, direction }) => `"${field}" ${direction}`);
+            orderByClause = `\nORDER BY ${orderParts.join(', ')}`;
+        }
+        let limitClause = '';
+        if (this.limitValue !== undefined) {
+            limitClause = `\nLIMIT ${this.limitValue}`;
+        }
+        if (this.offsetValue !== undefined) {
+            limitClause += `\nOFFSET ${this.offsetValue}`;
+        }
+        const sqlText = `WITH ${cteDecls.join(', ')}\n` +
+            `SELECT ${selectParts.join(', ')}\n${fromClause}${orderByClause}${limitClause}`;
+        return { sql: sqlText, params: ctx.params };
+    }
+    /** Generate the SQL string (for debugging / assertions). */
+    toSql() {
+        return this.buildQuery().sql;
+    }
+    /** Execute and return all rows. */
+    async toList() {
+        const { sql: sqlText, params } = this.buildQuery();
+        const result = this.executor
+            ? await this.executor.query(sqlText, params)
+            : await this.client.query(sqlText, params);
+        const selection = this.evaluateSelection();
+        return transformRows(result.rows, selection);
+    }
+    /** Execute and return the first row, or null. */
+    async first() {
+        const results = await this.limit(1).toList();
+        return results.length > 0 ? results[0] : null;
+    }
+    /** Evaluate the user selector against fresh CTE FieldRef proxies. */
+    evaluateSelection() {
+        const rootMock = createCteFieldRefProxy(this.rootCte);
+        const joinMocks = this.joinSteps.map(step => createCteFieldRefProxy(step.cte));
+        return this.selector(rootMock, ...joinMocks);
+    }
+}
+exports.CteRootQueryBuilder = CteRootQueryBuilder;
+/**
+ * The result of joining a CTE onto a CTE-rooted query. Carries the same build
+ * machinery as {@link CteRootQueryBuilder} but its `.select(...)` selector
+ * receives a FieldRef proxy per source (root first, then each joined CTE in
+ * order), and further joins can still be chained.
+ */
+class CteJoinedQueryBuilder extends CteRootQueryBuilder {
+    constructor() {
+        super(...arguments);
+        this._joinSteps = [];
+    }
+    /** @internal */
+    _inheritJoins(steps) {
+        this._joinSteps = steps;
+        this._setState(steps, undefined, [], undefined, undefined);
+    }
+    select(selector) {
+        const next = new CteRootQueryBuilder(this._getRootCte(), this.client, this.executor);
+        next._setState(this._joinSteps, selector, [], undefined, undefined);
+        return next;
+    }
+    /**
+     * Typed `fullOuterJoin` that exposes both already-joined sources (root +
+     * first right) to the predicate. (Re-declared so the chained right side keeps
+     * a useful element type rather than collapsing to the base signature.)
+     */
+    fullOuterJoin(cte, condition) {
+        return super.fullOuterJoin(cte, condition);
+    }
+}
+exports.CteJoinedQueryBuilder = CteJoinedQueryBuilder;
+/**
+ * Build SELECT list fragments from a projection object whose leaves are
+ * FieldRefs (qualified with their CTE/table alias), SqlFragments, or literals.
+ */
+function buildSelectParts(selection, ctx, defaultAlias) {
+    const parts = [];
+    for (const [key, value] of Object.entries(selection)) {
+        if (value instanceof conditions_1.SqlFragment) {
+            const fragmentSql = value.buildSql(ctx);
+            parts.push(`${fragmentSql} as "${key}"`);
+        }
+        else if (typeof value === 'object' && value !== null && '__dbColumnName' in value) {
+            const alias = value.__tableAlias || defaultAlias;
+            parts.push(`"${alias}"."${value.__dbColumnName}" as "${key}"`);
+        }
+        else if (typeof value === 'string') {
+            // Bare column name string — qualify with the root alias.
+            parts.push(`"${defaultAlias}"."${value}" as "${key}"`);
+        }
+        else {
+            // Literal value
+            ctx.params.push(value);
+            parts.push(`$${ctx.paramCounter++} as "${key}"`);
+        }
+    }
+    return parts;
+}
+/**
+ * Transform driver rows into the projected shape, re-applying any column /
+ * SqlFragment fromDriver mappers and coercing Postgres numeric strings to
+ * numbers. NULLs are preserved as `null` (faithful to the SQL — a CTE-rooted
+ * projection mirrors raw column output, unlike the entity path which maps
+ * absent columns to `undefined`).
+ */
+function transformRows(rows, selection) {
+    // Pre-analyze each selected field once.
+    const fields = [];
+    for (const [key, value] of Object.entries(selection)) {
+        let mapper;
+        if (value && typeof value === 'object' && typeof value.getMapper === 'function') {
+            let m = value.getMapper();
+            if (m && typeof m.getType === 'function') {
+                m = m.getType();
+            }
+            if (m && typeof m.fromDriver === 'function') {
+                mapper = m;
+            }
+        }
+        fields.push({ key, mapper });
+    }
+    return rows.map(row => {
+        const out = {};
+        for (const { key, mapper } of fields) {
+            const raw = row[key];
+            if (mapper) {
+                out[key] = mapper.fromDriver(raw);
+            }
+            else if (typeof raw === 'string' && NUMERIC_REGEX.test(raw)) {
+                out[key] = +raw;
+            }
+            else {
+                out[key] = raw;
+            }
+        }
+        return out;
+    });
+}
+//# sourceMappingURL=cte-root-query.js.map