@danceroutine/tango-orm 1.11.0 → 1.11.2

package/dist/{query-DUZnBFhf.js → query-CP1UMIX6.js}

@@ -1,21 +1,33 @@
-import { __export } from "./chunk-DLY2FNSh.js";
-import { InternalDialect } from "./InternalDialect-ClSaUNso.js";
+import { t as __exportAll } from "./chunk-8H4AJuhK.js";
+import { t as InternalDialect } from "./InternalDialect-U3mwJjKA.js";
 import { MultipleObjectsReturned, NotFoundError, SqlSafetyEngine, getLogger, isError } from "@danceroutine/tango-core";
 import { ModelRegistry } from "@danceroutine/tango-schema";
-
 //#region src/query/domain/RelationMeta.ts
 const InternalRelationHydrationLoadMode = {
 	JOIN: "join",
 	PREFETCH: "prefetch"
 };
-
 //#endregion
 //#region src/query/domain/internal/InternalPrefetchQueryKind.ts
+/**
+* Discriminator strings for compiled prefetch hydration: how `QueryCompiler.compilePrefetch`
+* batches related rows for hydration (`CompiledPrefetchQuery`).
+*/
 const InternalPrefetchQueryKind = {
+	/**
+	* Single-query prefetch against the related table (`SELECT … FROM target WHERE fk IN (...)`).
+	* Used when each related row is reachable from one physical table via a foreign key or
+	* symmetric join path (belongsTo, hasMany, hasOne, reverse one-to-one).
+	*/
 	DIRECT: "direct",
+	/**
+	* Two-phase many-to-many prefetch: first query reads join (through) rows pairing owner ids to
+	* target ids (`throughSql`), then target rows load by primary key (`compileManyToManyTargets`).
+	* Distinct from relation metadata’s `manyToMany` relation *kind* on an endpoint—this marks the
+	* compiled prefetch *strategy*, not the schema edge type.
+	*/
 	MANY_TO_MANY: "manyToMany"
 };
-
 //#endregion
 //#region src/query/domain/internal/InternalQNodeType.ts
 const InternalQNodeType = {
@@ -24,7 +36,6 @@ const InternalQNodeType = {
 	OR: "or",
 	NOT: "not"
 };
-
 //#endregion
 //#region src/query/domain/internal/InternalLookupType.ts
 const InternalLookupType = {
@@ -42,27 +53,47 @@ const InternalLookupType = {
 	ENDSWITH: "endswith",
 	IENDSWITH: "iendswith"
 };
-
 //#endregion
 //#region src/validation/internal/InternalSqlValidationPlanKind.ts
+/**
+* Discriminator strings for {@link SqlValidationPlan} / {@link ValidatedSqlPlan}: which validation
+* branch {@link OrmSqlSafetyAdapter} runs before SQL is assembled or executed.
+*/
 const InternalSqlValidationPlanKind = {
+	/**
+	* Read/query validation: table metadata, projected columns, `WHERE` filter keys, ordering, and
+	* optional relation handles. Used when compiling selects (including M2M through-table selects
+	* issued inside prefetch compilation).
+	*/
 	SELECT: "select",
+	/**
+	* Insert validation: resolved write columns for `INSERT … VALUES`.
+	*/
 	INSERT: "insert",
+	/**
+	* Update validation: resolved write columns for `UPDATE … SET`.
+	*/
 	UPDATE: "update",
+	/**
+	* Delete validation: scope delete-by-primary-key against validated table metadata.
+	*/
 	DELETE: "delete"
 };
-
 //#endregion
 //#region src/validation/internal/InternalValidatedFilterDescriptorKind.ts
 const InternalValidatedFilterDescriptorKind = {
 	COLUMN: "column",
 	RELATION: "relation"
 };
-
 //#endregion
 //#region src/validation/OrmSqlSafetyAdapter.ts
 const ALLOWED_LOOKUPS = Object.values(InternalLookupType);
+/**
+* ORM-local adapter that translates query validation plans into the
+* shared Tango SQL safety engine.
+*/
 var OrmSqlSafetyAdapter = class OrmSqlSafetyAdapter {
+	engine;
 	static BRAND = "tango.orm.orm_sql_safety_adapter";
 	__tangoBrand = OrmSqlSafetyAdapter.BRAND;
 	constructor(engine = new SqlSafetyEngine()) {
@@ -205,13 +236,13 @@ var OrmSqlSafetyAdapter = class OrmSqlSafetyAdapter {
 			allowed: ALLOWED_LOOKUPS
 		}] });
 		if (pathSegments.length === 1) {
-			const field$1 = pathSegments[0];
+			const field = pathSegments[0];
 			return {
 				kind: InternalValidatedFilterDescriptorKind.COLUMN,
 				rawKey,
-				field: field$1,
+				field,
 				lookup: validated.lookupTokens[rawKey].lookup,
-				qualifiedColumn: `${meta.table}.${this.resolveColumn(meta, field$1)}`
+				qualifiedColumn: `${meta.table}.${this.resolveColumn(meta, field)}`
 			};
 		}
 		const rootSegment = pathSegments[0];
@@ -252,17 +283,19 @@ var OrmSqlSafetyAdapter = class OrmSqlSafetyAdapter {
 		return relation;
 	}
 };
-
 //#endregion
 //#region src/query/domain/RelationTyping.ts
 const InternalRelationHydrationCardinality = {
 	SINGLE: "single",
 	MANY: "many"
 };
-
 //#endregion
 //#region src/query/planning/QueryPlanner.ts
+/**
+* Parse, validate, normalize, and plan recursive relation hydration paths.
+*/
 var QueryPlanner = class QueryPlanner {
+	meta;
 	static BRAND = "tango.orm.query_planner";
 	__tangoBrand = QueryPlanner.BRAND;
 	constructor(meta) {
@@ -278,7 +311,7 @@ var QueryPlanner = class QueryPlanner {
 			prefetchNodes: [],
 			requestedPaths: []
 		};
-		const rootChildren = new Map();
+		const rootChildren = /* @__PURE__ */ new Map();
 		for (const relationPath of new Set(state.selectRelated ?? [])) this.addPath(rootChildren, relationPath, "select");
 		for (const relationPath of new Set(state.prefetchRelated ?? [])) this.addPath(rootChildren, relationPath, "prefetch");
 		const { joinNodes, prefetchNodes } = this.buildPlannedChildren(rootChildren);
@@ -307,14 +340,13 @@ var QueryPlanner = class QueryPlanner {
 			const targetMeta = relation.targetMeta;
 			if (!targetMeta) throw new Error(`Relation path '${relationPath}' is missing target metadata.`);
 			builtPath = builtPath.length > 0 ? `${builtPath}__${segment}` : segment;
-			const existing = currentChildren.get(segment);
-			const nextNode = existing ?? {
+			const nextNode = currentChildren.get(segment) ?? {
 				segment,
 				relationEdge: relation,
 				relationPath: builtPath,
 				targetMeta,
-				provenance: new Set(),
-				children: new Map()
+				provenance: /* @__PURE__ */ new Set(),
+				children: /* @__PURE__ */ new Map()
 			};
 			nextNode.provenance.add(relationPath);
 			currentChildren.set(segment, nextNode);
@@ -341,7 +373,7 @@ var QueryPlanner = class QueryPlanner {
 				prefetchChildren
 			};
 			if (plannedNode.loadMode === InternalRelationHydrationLoadMode.JOIN) joinNodes.push(plannedNode);
-else prefetchNodes.push(plannedNode);
+			else prefetchNodes.push(plannedNode);
 		}
 		return {
 			joinNodes,
@@ -349,11 +381,16 @@ else prefetchNodes.push(plannedNode);
 		};
 	}
 };
-
 //#endregion
 //#region src/query/compiler/QueryCompiler.ts
 const sqlSafetyAdapter = new OrmSqlSafetyAdapter();
+/**
+* Compiles immutable `QuerySet` state into parameterized SQL and recursive
+* hydration execution artifacts.
+*/
 var QueryCompiler = class QueryCompiler {
+	meta;
+	adapter;
 	static BRAND = "tango.orm.query_compiler";
 	__tangoBrand = QueryCompiler.BRAND;
 	placeholders;
@@ -406,7 +443,7 @@ var QueryCompiler = class QueryCompiler {
 			ownerMeta: this.meta,
 			ownerAlias: table,
 			collectRootJoins: true,
-			rootSelectedFields: state.select?.map(String) ?? undefined,
+			rootSelectedFields: state.select?.map(String) ?? void 0,
 			hiddenRootAliases,
 			joinCollection
 		}));
@@ -415,7 +452,7 @@ var QueryCompiler = class QueryCompiler {
 			ownerMeta: this.meta,
 			ownerAlias: table,
 			collectRootJoins: false,
-			rootSelectedFields: state.select?.map(String) ?? undefined,
+			rootSelectedFields: state.select?.map(String) ?? void 0,
 			hiddenRootAliases,
 			joinCollection
 		}));
@@ -428,17 +465,15 @@ var QueryCompiler = class QueryCompiler {
 		const orderSQL = ` ORDER BY ${state.order?.length ? state.order.map((order) => `${validatedPlan.orderFields[String(order.by)]} ${order.dir.toUpperCase()}`).join(", ") : `${table}.${validatedPlan.meta.pk} ASC`}`;
 		const limitSQL = state.limit ? ` LIMIT ${state.limit}` : "";
 		const offsetSQL = state.offset ? ` OFFSET ${state.offset}` : "";
-		const sql = `SELECT ${select} FROM ${table}${joinCollection.joins.length ? ` ${joinCollection.joins.join(" ")}` : ""}${whereSQL}${orderSQL}${limitSQL}${offsetSQL}`;
-		const compiledHydrationPlan = compiledJoinNodes.length > 0 || compiledPrefetchNodes.length > 0 ? {
-			requestedPaths: hydrationPlan.requestedPaths,
-			hiddenRootAliases: [...new Set(hiddenRootAliases)],
-			joinNodes: compiledJoinNodes,
-			prefetchNodes: compiledPrefetchNodes
-		} : undefined;
 		return {
-			sql,
+			sql: `SELECT ${select} FROM ${table}${joinCollection.joins.length ? ` ${joinCollection.joins.join(" ")}` : ""}${whereSQL}${orderSQL}${limitSQL}${offsetSQL}`,
 			params,
-			hydrationPlan: compiledHydrationPlan
+			hydrationPlan: compiledJoinNodes.length > 0 || compiledPrefetchNodes.length > 0 ? {
+				requestedPaths: hydrationPlan.requestedPaths,
+				hiddenRootAliases: [...new Set(hiddenRootAliases)],
+				joinNodes: compiledJoinNodes,
+				prefetchNodes: compiledPrefetchNodes
+			} : void 0
 		};
 	}
 	compilePrefetch(node, sourceValues) {
@@ -469,9 +504,8 @@ var QueryCompiler = class QueryCompiler {
 			joins: []
 		};
 		for (const joinChild of node.joinChildren) this.collectNestedJoinSql(joinChild, baseAlias, validatedTarget.columns, joinCollection);
-		const baseSelects = Object.keys(validatedTarget.columns).map((column) => `${baseAlias}.${column} AS ${column}`);
 		return {
-			sql: `SELECT ${[...baseSelects, ...joinCollection.selects].join(", ")} FROM ${validatedTarget.table} ${baseAlias}${joinCollection.joins.length ? ` ${joinCollection.joins.join(" ")}` : ""} WHERE ${baseAlias}.${validatedTarget.primaryKey} IN (${placeholders}) ORDER BY ${baseAlias}.${validatedTarget.primaryKey} ASC`,
+			sql: `SELECT ${[...Object.keys(validatedTarget.columns).map((column) => `${baseAlias}.${column} AS ${column}`), ...joinCollection.selects].join(", ")} FROM ${validatedTarget.table} ${baseAlias}${joinCollection.joins.length ? ` ${joinCollection.joins.join(" ")}` : ""} WHERE ${baseAlias}.${validatedTarget.primaryKey} IN (${placeholders}) ORDER BY ${baseAlias}.${validatedTarget.primaryKey} ASC`,
 			params: targetIds
 		};
 	}
@@ -569,8 +603,7 @@ var QueryCompiler = class QueryCompiler {
 	}
 	buildRootHiddenSelects(nodes, table) {
 		return nodes.flatMap((node) => {
-			const select = node.ownerSourceAccessor !== node.sourceKey ? [`${table}.${node.sourceKey} AS ${node.ownerSourceAccessor}`] : [];
-			return [...select, ...this.buildRootHiddenSelects(node.prefetchChildren, table)];
+			return [...node.ownerSourceAccessor !== node.sourceKey ? [`${table}.${node.sourceKey} AS ${node.ownerSourceAccessor}`] : [], ...this.buildRootHiddenSelects(node.prefetchChildren, table)];
 		});
 	}
 	validatePrefetchTarget(node) {
@@ -650,8 +683,7 @@ var QueryCompiler = class QueryCompiler {
 		}
 	}
 	compileAtom(where, paramIndex, filterKeys) {
-		const entries = Object.entries(where).filter(([, value]) => value !== undefined);
-		const { parts, params } = entries.reduce((accumulator, [key, value]) => {
+		const { parts, params } = Object.entries(where).filter(([, value]) => value !== void 0).reduce((accumulator, [key, value]) => {
 			const descriptor = filterKeys[String(key)];
 			const idx = paramIndex + accumulator.params.length;
 			const clause = descriptor.kind === InternalValidatedFilterDescriptorKind.COLUMN ? this.lookupToSQL(descriptor.qualifiedColumn, descriptor.lookup, value, idx) : this.compileRelationFilter(descriptor, value, idx);
@@ -767,9 +799,8 @@ var QueryCompiler = class QueryCompiler {
 					sql: "1=0",
 					params: []
 				};
-				const placeholders = this.placeholders.listFromOffset(entries.length, paramIndex - 1);
 				return {
-					sql: `${col} IN (${placeholders})`,
+					sql: `${col} IN (${this.placeholders.listFromOffset(entries.length, paramIndex - 1)})`,
 					params: entries
 				};
 			}
@@ -781,35 +812,26 @@ var QueryCompiler = class QueryCompiler {
 				sql: `${col} LIKE ${placeholder}`,
 				params: [`%${value}%`]
 			};
-			case InternalLookupType.ICONTAINS: {
-				const lowerCol = this.adapter.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`;
-				return {
-					sql: `${lowerCol} LIKE ${placeholder}`,
-					params: [`%${String(value).toLowerCase()}%`]
-				};
-			}
+			case InternalLookupType.ICONTAINS: return {
+				sql: `${this.adapter.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`} LIKE ${placeholder}`,
+				params: [`%${String(value).toLowerCase()}%`]
+			};
 			case InternalLookupType.STARTSWITH: return {
 				sql: `${col} LIKE ${placeholder}`,
 				params: [`${value}%`]
 			};
-			case InternalLookupType.ISTARTSWITH: {
-				const lowerCol = this.adapter.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`;
-				return {
-					sql: `${lowerCol} LIKE ${placeholder}`,
-					params: [`${String(value).toLowerCase()}%`]
-				};
-			}
+			case InternalLookupType.ISTARTSWITH: return {
+				sql: `${this.adapter.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`} LIKE ${placeholder}`,
+				params: [`${String(value).toLowerCase()}%`]
+			};
 			case InternalLookupType.ENDSWITH: return {
 				sql: `${col} LIKE ${placeholder}`,
 				params: [`%${value}`]
 			};
-			case InternalLookupType.IENDSWITH: {
-				const lowerCol = this.adapter.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`;
-				return {
-					sql: `${lowerCol} LIKE ${placeholder}`,
-					params: [`%${String(value).toLowerCase()}`]
-				};
-			}
+			case InternalLookupType.IENDSWITH: return {
+				sql: `${this.adapter.dialect === InternalDialect.POSTGRES ? `LOWER(${col})` : `${col}`} LIKE ${placeholder}`,
+				params: [`%${String(value).toLowerCase()}`]
+			};
 			default: throw new Error(`Unknown lookup: ${lookup}`);
 		}
 	}
@@ -818,7 +840,7 @@ var QueryCompiler = class QueryCompiler {
 		return value;
 	}
 	collectStateFilterKeys(state) {
-		const filterKeys = new Set();
+		const filterKeys = /* @__PURE__ */ new Set();
 		if (state.q) this.collectNodeFilterKeys(state.q, filterKeys);
 		state.excludes?.forEach((exclude) => this.collectNodeFilterKeys(exclude, filterKeys));
 		return [...filterKeys];
@@ -829,15 +851,17 @@ var QueryCompiler = class QueryCompiler {
 		if (node.node) this.collectNodeFilterKeys(node.node, filterKeys);
 	}
 };
-
 //#endregion
 //#region src/query/compiler/index.ts
-var compiler_exports = {};
-__export(compiler_exports, { QueryCompiler: () => QueryCompiler });
-
+var compiler_exports = /* @__PURE__ */ __exportAll({ QueryCompiler: () => QueryCompiler });
 //#endregion
 //#region src/query/domain/QueryResult.ts
 let didWarnDeprecatedResults = false;
+/**
+* Values materialized by {@link QuerySet.fetch}, iterable like an array plus `length`, `map`, `at`, and `toArray`.
+*
+* Prefer iteration or `items` over the deprecated `results` getter, which warns once per process when accessed.
+*/
 var QueryResult = class QueryResult {
 	static BRAND = "tango.orm.query_result";
 	__tangoBrand = QueryResult.BRAND;
@@ -884,7 +908,6 @@ var QueryResult = class QueryResult {
 		return this.items;
 	}
 };
-
 //#endregion
 //#region src/query/domain/internal/InternalRelationKind.ts
 const InternalRelationKind = {
@@ -893,13 +916,16 @@ const InternalRelationKind = {
 	HAS_ONE: "hasOne",
 	MANY_TO_MANY: "manyToMany"
 };
-
 //#endregion
 //#region src/query/domain/TableMetaFactory.ts
+/**
+* Build registry-backed recursive table metadata for query planning and
+* hydration execution.
+*/
 var TableMetaFactory = class TableMetaFactory {
 	static create(model) {
-		const owner = model.metadata.key ? ModelRegistry.getOwner(model) : undefined;
-		const cache = new Map();
+		const owner = model.metadata.key ? ModelRegistry.getOwner(model) : void 0;
+		const cache = /* @__PURE__ */ new Map();
 		return TableMetaFactory.createWithCache(model, owner, cache);
 	}
 	static createWithCache(model, owner, cache) {
@@ -965,23 +991,19 @@ var TableMetaFactory = class TableMetaFactory {
 		return tableMeta;
 	}
 };
-
 //#endregion
 //#region src/query/domain/index.ts
-var domain_exports = {};
-__export(domain_exports, {
+var domain_exports = /* @__PURE__ */ __exportAll({
 	InternalRelationHydrationCardinality: () => InternalRelationHydrationCardinality,
 	QueryResult: () => QueryResult,
 	TableMetaFactory: () => TableMetaFactory
 });
-
 //#endregion
 //#region src/query/domain/internal/InternalDirection.ts
 const InternalDirection = {
 	ASC: "asc",
 	DESC: "desc"
 };
-
 //#endregion
 //#region src/query/internal/isQNodeLike.ts
 function isQNodeLike(value) {
@@ -994,9 +1016,14 @@ function isQNodeLike(value) {
 		default: return false;
 	}
 }
-
 //#endregion
 //#region src/query/QBuilder.ts
+/**
+* Static builder for composing boolean query expressions.
+*
+* This mirrors Django's `Q(...)` composition patterns and is intended
+* for ergonomic construction of nested `AND`/`OR`/`NOT` trees.
+*/
 var QBuilder = class QBuilder {
 	static BRAND = "tango.orm.q_builder";
 	__tangoBrand = QBuilder.BRAND;
@@ -1041,10 +1068,32 @@ var QBuilder = class QBuilder {
 		};
 	}
 };
-
 //#endregion
 //#region src/query/QuerySet.ts
+/**
+* Django-inspired query builder for constructing and executing database queries.
+* Provides a fluent API for filtering, ordering, pagination, projection, and
+* nested relation hydration.
+*
+* @template TModel - The full model row type used for query composition
+* @template TBaseResult - The selected base-row shape returned by execution methods
+* @template TSourceModel - The source Tango model used for typed relation metadata
+* @template THydrated - Relation properties accumulated by eager-loading calls
+*
+* @example
+* ```typescript
+* const users = await TodoModel.objects
+*   .query()
+*   .filter({ active: true })
+*   .filter(Q.or({ role: 'admin' }, { role: 'moderator' }))
+*   .orderBy('-createdAt')
+*   .limit(10)
+*   .fetch();
+* ```
+*/
 var QuerySet = class QuerySet {
+	executor;
+	state;
 	static BRAND = "tango.orm.query_set";
 	__tangoBrand = QuerySet.BRAND;
 	evaluationCache;
@@ -1186,8 +1235,7 @@ var QuerySet = class QuerySet {
 	async fetch(shape) {
 		const baseResult = await this.getOrCreateEvaluationCache();
 		if (!shape) return baseResult;
-		const results = typeof shape === "function" ? baseResult.items.map(shape) : this.normalizeHydratedRowsForParserShape(baseResult.items).map((row) => shape.parse(row));
-		return new QueryResult(results);
+		return new QueryResult(typeof shape === "function" ? baseResult.items.map(shape) : this.normalizeHydratedRowsForParserShape(baseResult.items).map((row) => shape.parse(row)));
 	}
 	/**
 	* Async iterable surface for `for await (... of queryset)`.
@@ -1211,9 +1259,8 @@ var QuerySet = class QuerySet {
 		return this.fetchOne(shape);
 	}
 	async last(shape) {
-		if (this.state.limit !== undefined || this.state.offset !== undefined) {
-			const page = await this.fetch();
-			const row = page.at(-1);
+		if (this.state.limit !== void 0 || this.state.offset !== void 0) {
+			const row = (await this.fetch()).at(-1);
 			if (!row) return null;
 			return this.shapeFetchedRow(row, shape);
 		}
@@ -1222,16 +1269,13 @@ var QuerySet = class QuerySet {
 			by: this.executor.meta.pk,
 			dir: InternalDirection.DESC
 		}];
-		const qs = this.spawn({
+		return this.spawn({
 			...this.state,
 			order: effectiveOrder
-		});
-		return qs.limit(1).fetchOne(shape);
+		}).limit(1).fetchOne(shape);
 	}
 	async get(q, shape) {
-		const limited = this.filter(q).limit(2);
-		const page = await limited.fetch();
-		const rows = page.items;
+		const rows = (await this.filter(q).limit(2).fetch()).items;
 		if (rows.length === 0) throw new NotFoundError(`${this.executor.meta.table}: no matching record`);
 		if (rows.length > 1) throw new MultipleObjectsReturned(`${this.executor.meta.table}: more than one matching record`);
 		return this.shapeFetchedRow(rows[0], shape);
@@ -1240,8 +1284,7 @@ var QuerySet = class QuerySet {
 	* Execute a `COUNT(*)` query for the current filtered state.
 	*/
 	async count() {
-		const compiler = new QueryCompiler(this.executor.meta, this.executor.adapter);
-		const compiled = compiler.compile(this.withoutHydrationState());
+		const compiled = new QueryCompiler(this.executor.meta, this.executor.adapter).compile(this.withoutHydrationState());
 		const countQuery = `SELECT COUNT(*) as count FROM (${compiled.sql}) AS tango_count_subquery`;
 		const rows = await this.executor.client.query(countQuery, compiled.params);
 		return Number(rows.rows[0]?.count ?? 0);
@@ -1250,8 +1293,7 @@ var QuerySet = class QuerySet {
 	* Return whether at least one row matches the current query state.
 	*/
 	async exists() {
-		const count = await this.count();
-		return count > 0;
+		return await this.count() > 0;
 	}
 	shapeFetchedRow(row, shape) {
 		if (!shape) return row;
@@ -1261,20 +1303,18 @@ var QuerySet = class QuerySet {
 	}
 	getOrCreateEvaluationCache() {
 		if (!this.evaluationCache) this.evaluationCache = this.evaluateRows().catch((error) => {
-			this.evaluationCache = undefined;
+			this.evaluationCache = void 0;
 			throw error;
 		});
 		return this.evaluationCache;
 	}
 	async evaluateRows() {
-		const compiler = new QueryCompiler(this.executor.meta, this.executor.adapter);
-		const compiled = compiler.compile(this.state);
+		const compiled = new QueryCompiler(this.executor.meta, this.executor.adapter).compile(this.state);
 		const rows = await this.executor.run(compiled);
 		const normalizedRows = this.normalizeRowsForSchemaParsing(rows);
 		const hydratedRows = await this.hydrateRows(normalizedRows, compiled);
 		this.attachRootRecordAccessors(hydratedRows);
-		const projectedRows = hydratedRows;
-		return new QueryResult(projectedRows);
+		return new QueryResult(hydratedRows);
 	}
 	normalizeRowsForSchemaParsing(rows) {
 		if (this.executor.adapter.dialect !== InternalDialect.SQLITE) return [...rows];
@@ -1292,8 +1332,8 @@ var QuerySet = class QuerySet {
 		if (!compiled.hydrationPlan) return rows;
 		const hydratedRows = rows.map((row) => ({ ...row }));
 		this.attachRootRecordAccessors(hydratedRows);
-		const canonicalEntities = new Map();
-		const queuedJoinPrefetchOwners = new Map();
+		const canonicalEntities = /* @__PURE__ */ new Map();
+		const queuedJoinPrefetchOwners = /* @__PURE__ */ new Map();
 		const compiler = new QueryCompiler(this.executor.meta, this.executor.adapter);
 		for (const row of hydratedRows) this.hydrateJoinNodesForOwner(row, row, compiled.hydrationPlan.joinNodes, canonicalEntities, queuedJoinPrefetchOwners);
 		for (const node of compiled.hydrationPlan.prefetchNodes) await this.hydratePrefetchNode(node, hydratedRows, canonicalEntities, compiler);
@@ -1323,7 +1363,7 @@ var QuerySet = class QuerySet {
 				const value = rawRow[alias];
 				delete rawRow[alias];
 				target[column] = this.normalizeColumnValue(node.targetColumns[column], value);
-				if (value !== null && value !== undefined) hasTargetValue = true;
+				if (value !== null && value !== void 0) hasTargetValue = true;
 			}
 			if (!hasTargetValue) {
 				owner[node.relationName] = null;
@@ -1346,14 +1386,13 @@ var QuerySet = class QuerySet {
 		if (owners.length === 0) return;
 		const groupedOwners = this.groupOwnersByAccessor(owners, node.ownerSourceAccessor);
 		const sourceValues = [...groupedOwners.keys()];
-		const isManyToMany = !!node.throughTable;
-		if (!isManyToMany) for (const owner of owners) owner[node.relationName] = node.cardinality === InternalRelationHydrationCardinality.MANY ? [] : null;
+		if (!!!node.throughTable) for (const owner of owners) owner[node.relationName] = node.cardinality === InternalRelationHydrationCardinality.MANY ? [] : null;
 		if (sourceValues.length === 0) return;
 		const sourceChunks = this.chunkValues(sourceValues, 500);
 		const compiledPrefetch = compiler.compilePrefetch(node, sourceChunks[0]);
 		if (compiledPrefetch.kind === InternalPrefetchQueryKind.MANY_TO_MANY) {
-			const idsByOwner = new Map();
-			const uniqueTargetIds = new Set();
+			const idsByOwner = /* @__PURE__ */ new Map();
+			const uniqueTargetIds = /* @__PURE__ */ new Set();
 			for (const chunk of sourceChunks) {
 				const chunkCompiled = compiler.compilePrefetch(node, chunk);
 				const throughResult = await this.executor.client.query(chunkCompiled.throughSql, chunkCompiled.throughParams);
@@ -1380,22 +1419,22 @@ var QuerySet = class QuerySet {
 					if (typeof primaryKey === "string" || typeof primaryKey === "number") targets[primaryKey] = canonical;
 				}
 			}
-			const canonicalChildren$1 = new Map();
-			const handledOwners = new Set();
+			const canonicalChildren = /* @__PURE__ */ new Map();
+			const handledOwners = /* @__PURE__ */ new Set();
 			for (const [ownerId, ids] of idsByOwner.entries()) {
 				const bucket = ids.map((id) => targets[id]).filter((value) => !!value);
 				for (const owner of groupedOwners.get(ownerId) ?? []) {
 					this.primeManyToManyOwnerCache(owner, node.relationName, bucket);
 					handledOwners.add(owner);
 				}
-				for (const child of bucket) canonicalChildren$1.set(child[node.targetPrimaryKey], child);
+				for (const child of bucket) canonicalChildren.set(child[node.targetPrimaryKey], child);
 			}
 			for (const owner of owners) if (!handledOwners.has(owner)) this.primeManyToManyOwnerCache(owner, node.relationName, []);
-			const childOwners$1 = [...canonicalChildren$1.values()];
-			for (const childNode of node.prefetchChildren) await this.hydratePrefetchNode(childNode, childOwners$1, canonicalEntities, compiler);
+			const childOwners = [...canonicalChildren.values()];
+			for (const childNode of node.prefetchChildren) await this.hydratePrefetchNode(childNode, childOwners, canonicalEntities, compiler);
 			return;
 		}
-		const canonicalChildren = new Map();
+		const canonicalChildren = /* @__PURE__ */ new Map();
 		for (const chunk of sourceChunks) {
 			const chunkCompiled = compiler.compilePrefetch(node, chunk);
 			const result = await this.executor.client.query(chunkCompiled.sql, chunkCompiled.params);
@@ -1406,7 +1445,7 @@ var QuerySet = class QuerySet {
 				const key = normalized[chunkCompiled.targetKey];
 				if (typeof key !== "string" && typeof key !== "number") continue;
 				for (const owner of groupedOwners.get(key) ?? []) if (node.cardinality === InternalRelationHydrationCardinality.MANY) owner[node.relationName].push(canonical);
-else if (owner[node.relationName] === null) owner[node.relationName] = canonical;
+				else if (owner[node.relationName] === null) owner[node.relationName] = canonical;
 				const childPrimaryKey = canonical[node.targetPrimaryKey];
 				if (typeof childPrimaryKey === "string" || typeof childPrimaryKey === "number") canonicalChildren.set(childPrimaryKey, canonical);
 			}
@@ -1422,7 +1461,7 @@ else if (owner[node.relationName] === null) owner[node.relationName] = canonical
 		return chunks;
 	}
 	groupOwnersByAccessor(owners, accessor) {
-		const grouped = new Map();
+		const grouped = /* @__PURE__ */ new Map();
 		for (const owner of owners) {
 			const key = owner[accessor];
 			if (typeof key !== "string" && typeof key !== "number") continue;
@@ -1435,7 +1474,7 @@ else if (owner[node.relationName] === null) owner[node.relationName] = canonical
 	canonicalizeEntity(node, row, canonicalEntities) {
 		const primaryKeyValue = row[node.targetPrimaryKey];
 		if (typeof primaryKeyValue !== "string" && typeof primaryKeyValue !== "number") return row;
-		const byModel = canonicalEntities.get(node.targetModelKey) ?? new Map();
+		const byModel = canonicalEntities.get(node.targetModelKey) ?? /* @__PURE__ */ new Map();
 		const existing = byModel.get(primaryKeyValue);
 		if (existing) {
 			Object.assign(existing, row);
@@ -1481,13 +1520,18 @@ else if (owner[node.relationName] === null) owner[node.relationName] = canonical
 		return normalized ?? row;
 	}
 	withoutHydrationState() {
-		const { selectRelated: _selectRelated, prefetchRelated: _prefetchRelated,...rest } = this.state;
+		const { selectRelated: _selectRelated, prefetchRelated: _prefetchRelated, ...rest } = this.state;
 		return rest;
 	}
 };
-
 //#endregion
 //#region src/query/ModelQuerySet.ts
+/**
+* Concrete `QuerySet` implementation returned by `Model.objects.query()`.
+*
+* It executes the accumulated queryset state directly against the bound
+* model executor.
+*/
 var ModelQuerySet = class ModelQuerySet extends QuerySet {
 	constructor(executor, state = {}) {
 		super(executor, state);
@@ -1496,11 +1540,9 @@ var ModelQuerySet = class ModelQuerySet extends QuerySet {
 		return new ModelQuerySet(this.executor, state);
 	}
 };
-
 //#endregion
 //#region src/query/index.ts
-var query_exports = {};
-__export(query_exports, {
+var query_exports = /* @__PURE__ */ __exportAll({
 	ModelQuerySet: () => ModelQuerySet,
 	Q: () => QBuilder,
 	QBuilder: () => QBuilder,
@@ -1510,7 +1552,7 @@ __export(query_exports, {
 	compiler: () => compiler_exports,
 	domain: () => domain_exports
 });
-
 //#endregion
-export { InternalQNodeType, InternalRelationKind, InternalSqlValidationPlanKind, ModelQuerySet, OrmSqlSafetyAdapter, QBuilder, QueryCompiler, QueryResult, QuerySet, TableMetaFactory, compiler_exports, domain_exports, isQNodeLike, query_exports };
-//# sourceMappingURL=query-DUZnBFhf.js.map
+export { isQNodeLike as a, InternalRelationKind as c, QueryCompiler as d, OrmSqlSafetyAdapter as f, QBuilder as i, QueryResult as l, InternalQNodeType as m, ModelQuerySet as n, domain_exports as o, InternalSqlValidationPlanKind as p, QuerySet as r, TableMetaFactory as s, query_exports as t, compiler_exports as u };
+
+//# sourceMappingURL=query-CP1UMIX6.js.map