joist-core 2.3.0 → 2.4.0

package/build/plugins/ImmutableEntitiesPlugin.js

@@ -1,21 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ImmutableEntitiesPlugin = void 0;
-const PluginManager_1 = require("../PluginManager");
-const utils_1 = require("../utils");
-class ImmutableEntitiesPlugin extends PluginManager_1.Plugin {
-    entities = new Set();
-    beforeSetField(entity, field, newValue) {
-        if (this.entities.has(entity)) {
-            (0, utils_1.fail)(`Cannot set field ${field} on immutable entity ${entity}`);
-        }
-    }
-    addEntity(entity) {
-        this.entities.add(entity);
-    }
-    removeEntity(entity) {
-        this.entities.delete(entity);
-    }
-}
-exports.ImmutableEntitiesPlugin = ImmutableEntitiesPlugin;
+import { fail } from "../utils.js";
+import { Plugin } from "../PluginManager.js";
+import "../Entity.js";
+//#region src/plugins/ImmutableEntitiesPlugin.ts
+var ImmutableEntitiesPlugin = class extends Plugin {
+	entities = /* @__PURE__ */ new Set();
+	beforeSetField(entity, field, newValue) {
+		if (this.entities.has(entity)) fail(`Cannot set field ${field} on immutable entity ${entity}`);
+	}
+	addEntity(entity) {
+		this.entities.add(entity);
+	}
+	removeEntity(entity) {
+		this.entities.delete(entity);
+	}
+};
+//#endregion
+export { ImmutableEntitiesPlugin };
+
 //# sourceMappingURL=ImmutableEntitiesPlugin.js.map

package/build/plugins/ImmutableEntitiesPlugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"ImmutableEntitiesPlugin.js","sourceRoot":"","sources":["../../src/plugins/ImmutableEntitiesPlugin.ts"],"names":[],"mappings":";;;AACA,oDAA0C;AAC1C,oCAAgC;AAEhC,MAAa,uBAAwB,SAAQ,sBAAM;IACxC,QAAQ,GAAgB,IAAI,GAAG,EAAE,CAAC;IAE3C,cAAc,CAAC,MAAc,EAAE,KAAa,EAAE,QAAa;QACzD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9B,IAAA,YAAI,EAAC,oBAAoB,KAAK,wBAAwB,MAAM,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAED,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AAhBD,0DAgBC"}
+{"version":3,"file":"ImmutableEntitiesPlugin.js","names":[],"sources":["../../src/plugins/ImmutableEntitiesPlugin.ts"],"sourcesContent":["import { type Entity } from \"src/Entity.ts\";\nimport { Plugin } from \"src/PluginManager.ts\";\nimport { fail } from \"src/utils.ts\";\n\nexport class ImmutableEntitiesPlugin extends Plugin {\n  readonly entities: Set<Entity> = new Set();\n\n  beforeSetField(entity: Entity, field: string, newValue: any): void {\n    if (this.entities.has(entity)) {\n      fail(`Cannot set field ${field} on immutable entity ${entity}`);\n    }\n  }\n\n  addEntity(entity: Entity) {\n    this.entities.add(entity);\n  }\n\n  removeEntity(entity: Entity) {\n    this.entities.delete(entity);\n  }\n}\n"],"mappings":";;;;AAIA,IAAa,0BAAb,cAA6C,OAAO;CAClD,2BAAiC,IAAI,IAAI;CAEzC,eAAe,QAAgB,OAAe,UAAqB;EACjE,IAAI,KAAK,SAAS,IAAI,MAAM,GAC1B,KAAK,oBAAoB,MAAM,uBAAuB,QAAQ;CAElE;CAEA,UAAU,QAAgB;EACxB,KAAK,SAAS,IAAI,MAAM;CAC1B;CAEA,aAAa,QAAgB;EAC3B,KAAK,SAAS,OAAO,MAAM;CAC7B;AACF"}

package/build/plugins/PreloadPlugin.cjs

@@ -0,0 +1,3 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../EntityMetadata.cjs");
+require("../Entity.cjs");

package/build/plugins/PreloadPlugin.d.cts

@@ -0,0 +1,77 @@
+import { LateralJoinTable, ParsedFindQuery } from "../queries/find/QueryParser.cjs";
+import { LoadHint, NestedLoadHint } from "../loading/loadHints.cjs";
+import { RowData } from "../RowData.cjs";
+import { EntityMetadata } from "../EntityMetadata.cjs";
+import { EntityOrId, HintNode } from "../loading/HintTree.cjs";
+import { Entity } from "../Entity.cjs";
+//#region src/plugins/PreloadPlugin.d.ts
+/**
+ * This is a plugin API dedicated to preloading data for subtrees of entities.
+ *
+ * I.e. when evaluating `em.load(Author, "a:1", { books: "reviews" })`, loading both the
+ * Author `a:1` plus all the author's books, and all the author's books' reviews, in a single
+ * SQL call.
+ *
+ * Implementations of this API should execute the SQL queries necessary to load the data, and
+ * then store the preloaded data in the `EntityManager.preloadedRelations` cache, which the
+ * `OneToManyCollection`, `ManyToOneReference`, etc. relation implementations check before
+ * issuing their own `.load()` SQL calls.
+ */
+interface PreloadPlugin {
+  /**
+   * Given a single load hint, partitions it into the sql-able and non-sql-able parts.
+   *
+   * The sql-able hints will later be passed to `preloadPopulate` to fetch as a single
+   * SQL call.
+   */
+  partitionHint(meta: EntityMetadata | undefined, hint: LoadHint<any>): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined];
+  /**
+   * Given an existing `ParsedFindQuery`, adds extra selects & joins directly
+   * to the `query` that will preload any child data requested in `tree`.
+   *
+   * The caller is still responsible for executing `query`, and then also
+   * calling the `PreloadHydrator` with the database results for the preload
+   * plugin to instantiate & populate the EM's preload cache.
+   *
+   * Note that the actual relations themselves won't be loaded, just the preload
+   * cache populated to make the relation `.preload()` / `.load()` fast.
+   */
+  addPreloading<T extends Entity>(meta: EntityMetadata, tree: HintNode<EntityOrId>, query: ParsedFindQuery): PreloadHydrator | undefined;
+  /**
+   * Given an anticipated `ParsedFindQuery`, returns lower-level `JoinResult` that
+   * are the fragments of SELECTs and JOINs that the caller can work into their custom
+   * query.
+   *
+   * This is primarily for callers who aren't going to call `driver.executeFind`, but instead
+   * are crafting their own SQL query for `driver.executeQuery` (basically this is `em.findAll`
+   * because it uses a complicated CTE + join strategy to do batching).
+   */
+  getPreloadJoins<T extends Entity>(meta: EntityMetadata, tree: HintNode<EntityOrId>, query: ParsedFindQuery): JoinResult[];
+}
+/**
+ * Given the query's rows — classic POJO rows, or a `RowData` result in lazy-rows mode — and the
+ * already-hydrated `entities` for each row, reads the preload-specific columns out of the result
+ * set, and pushes them into the EM preload cache, hydrating the child entities in the process,
+ * but not marking any relations as loaded.
+ *
+ * Classic loaders keep passing plain row arrays (the pre-RowData contract), so existing plugin
+ * implementations that only handle arrays continue to work everywhere except lazy-rows mode.
+ *
+ * The order of the rows and `entities` must match.
+ */
+type PreloadHydrator = (rows: any[] | RowData, entities: any[]) => void;
+/** A preload-loadable join for a given child, with potentially grand-child joins contained within it. */
+type JoinResult = {
+  /** The select clause(s) for this join, i.e. `b._ as _b` or `c._ as _c`. */
+  selects: {
+    value: string;
+    as: string;
+  }[];
+  /** The SQL for this child's lateral join, which itself might have recursive lateral joins. */
+  join: LateralJoinTable;
+  /** The processor for this child's lateral join, which itself might recursively processor subjoins. */
+  hydrator: PreloadHydrator;
+};
+//#endregion
+export { JoinResult, PreloadHydrator, PreloadPlugin };
+//# sourceMappingURL=PreloadPlugin.d.cts.map

package/build/plugins/PreloadPlugin.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreloadPlugin.d.cts","names":[],"sources":["../../src/plugins/PreloadPlugin.ts"],"mappings":";;;;;;;;;;;;;;;;;;;UAmBiB;;;;;;;EAOf,cACE,MAAM,4BACN,MAAM,iBACJ,iCAAiC;;;;;;;;;;;;EAarC,cAAc,UAAU,QACtB,MAAM,gBACN,MAAM,SAAS,aACf,OAAO,kBACN;;;;;;;;;;EAWH,gBAAgB,UAAU,QACxB,MAAM,gBACN,MAAM,SAAS,aACf,OAAO,kBACN;;;;;;;;;;;;;KAcO,mBAAmB,cAAc,SAAS;;KAG1C;;EAEV;IAAW;IAAe;;;EAE1B,MAAM;;EAEN,UAAU"}

package/build/plugins/PreloadPlugin.d.mts

@@ -0,0 +1,77 @@
+import { LateralJoinTable, ParsedFindQuery } from "../queries/find/QueryParser.mjs";
+import { LoadHint, NestedLoadHint } from "../loading/loadHints.mjs";
+import { RowData } from "../RowData.mjs";
+import { EntityMetadata } from "../EntityMetadata.mjs";
+import { EntityOrId, HintNode } from "../loading/HintTree.mjs";
+import { Entity } from "../Entity.mjs";
+//#region src/plugins/PreloadPlugin.d.ts
+/**
+ * This is a plugin API dedicated to preloading data for subtrees of entities.
+ *
+ * I.e. when evaluating `em.load(Author, "a:1", { books: "reviews" })`, loading both the
+ * Author `a:1` plus all the author's books, and all the author's books' reviews, in a single
+ * SQL call.
+ *
+ * Implementations of this API should execute the SQL queries necessary to load the data, and
+ * then store the preloaded data in the `EntityManager.preloadedRelations` cache, which the
+ * `OneToManyCollection`, `ManyToOneReference`, etc. relation implementations check before
+ * issuing their own `.load()` SQL calls.
+ */
+interface PreloadPlugin {
+  /**
+   * Given a single load hint, partitions it into the sql-able and non-sql-able parts.
+   *
+   * The sql-able hints will later be passed to `preloadPopulate` to fetch as a single
+   * SQL call.
+   */
+  partitionHint(meta: EntityMetadata | undefined, hint: LoadHint<any>): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined];
+  /**
+   * Given an existing `ParsedFindQuery`, adds extra selects & joins directly
+   * to the `query` that will preload any child data requested in `tree`.
+   *
+   * The caller is still responsible for executing `query`, and then also
+   * calling the `PreloadHydrator` with the database results for the preload
+   * plugin to instantiate & populate the EM's preload cache.
+   *
+   * Note that the actual relations themselves won't be loaded, just the preload
+   * cache populated to make the relation `.preload()` / `.load()` fast.
+   */
+  addPreloading<T extends Entity>(meta: EntityMetadata, tree: HintNode<EntityOrId>, query: ParsedFindQuery): PreloadHydrator | undefined;
+  /**
+   * Given an anticipated `ParsedFindQuery`, returns lower-level `JoinResult` that
+   * are the fragments of SELECTs and JOINs that the caller can work into their custom
+   * query.
+   *
+   * This is primarily for callers who aren't going to call `driver.executeFind`, but instead
+   * are crafting their own SQL query for `driver.executeQuery` (basically this is `em.findAll`
+   * because it uses a complicated CTE + join strategy to do batching).
+   */
+  getPreloadJoins<T extends Entity>(meta: EntityMetadata, tree: HintNode<EntityOrId>, query: ParsedFindQuery): JoinResult[];
+}
+/**
+ * Given the query's rows — classic POJO rows, or a `RowData` result in lazy-rows mode — and the
+ * already-hydrated `entities` for each row, reads the preload-specific columns out of the result
+ * set, and pushes them into the EM preload cache, hydrating the child entities in the process,
+ * but not marking any relations as loaded.
+ *
+ * Classic loaders keep passing plain row arrays (the pre-RowData contract), so existing plugin
+ * implementations that only handle arrays continue to work everywhere except lazy-rows mode.
+ *
+ * The order of the rows and `entities` must match.
+ */
+type PreloadHydrator = (rows: any[] | RowData, entities: any[]) => void;
+/** A preload-loadable join for a given child, with potentially grand-child joins contained within it. */
+type JoinResult = {
+  /** The select clause(s) for this join, i.e. `b._ as _b` or `c._ as _c`. */
+  selects: {
+    value: string;
+    as: string;
+  }[];
+  /** The SQL for this child's lateral join, which itself might have recursive lateral joins. */
+  join: LateralJoinTable;
+  /** The processor for this child's lateral join, which itself might recursively processor subjoins. */
+  hydrator: PreloadHydrator;
+};
+//#endregion
+export { JoinResult, PreloadHydrator, PreloadPlugin };
+//# sourceMappingURL=PreloadPlugin.d.mts.map

package/build/plugins/PreloadPlugin.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PreloadPlugin.d.mts","names":[],"sources":["../../src/plugins/PreloadPlugin.ts"],"mappings":";;;;;;;;;;;;;;;;;;;UAmBiB;;;;;;;EAOf,cACE,MAAM,4BACN,MAAM,iBACJ,iCAAiC;;;;;;;;;;;;EAarC,cAAc,UAAU,QACtB,MAAM,gBACN,MAAM,SAAS,aACf,OAAO,kBACN;;;;;;;;;;EAWH,gBAAgB,UAAU,QACxB,MAAM,gBACN,MAAM,SAAS,aACf,OAAO,kBACN;;;;;;;;;;;;;KAcO,mBAAmB,cAAc,SAAS;;KAG1C;;EAEV;IAAW;IAAe;;;EAE1B,MAAM;;EAEN,UAAU"}

package/build/plugins/PreloadPlugin.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=PreloadPlugin.js.map
+import "../EntityMetadata.js";
+import "../Entity.js";
+export {};

package/build/preloading/JsonAggregatePreloader.cjs

@@ -0,0 +1,280 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_keys = require("../keys.cjs");
+const require_queries_sql_keywords = require("../queries/sql/keywords.cjs");
+const require_queries_ConditionBuilder = require("../queries/ConditionBuilder.cjs");
+const require_queries_find_QueryParser = require("../queries/find/QueryParser.cjs");
+const require_utils = require("../utils.cjs");
+const require_EntityMetadata = require("../EntityMetadata.cjs");
+const require_preloading_canPreload = require("./canPreload.cjs");
+const require_preloading_partitionHint = require("./partitionHint.cjs");
+const require_queries_sql_AliasAssigner = require("../queries/sql/AliasAssigner.cjs");
+require("../plugins/PreloadPlugin.cjs");
+const require_EntityManager = require("../EntityManager.cjs");
+require("../Entity.cjs");
+//#region src/preloading/JsonAggregatePreloader.ts
+/**
+* A PreloadPlugin implementation that uses `CROSS LATERAL JOIN` and `json_aggregate`
+* to preload/reduce a subtree of data while still being a single row of data.
+*/
+var JsonAggregatePreloader = class {
+	partitionHint(meta, hint) {
+		return require_preloading_partitionHint.partitionHint(meta, hint);
+	}
+	addPreloading(meta, root, query) {
+		const assigner = new require_queries_sql_AliasAssigner.AliasAssigner(query);
+		const alias = require_queries_find_QueryParser.getTables(query)[0].alias;
+		const joins = calcLateralJoins(assigner, {
+			tree: root,
+			alias,
+			meta
+		}, root, alias, meta);
+		if (joins.length === 0) return void 0;
+		for (const { alias, relationAlias, join } of joins) {
+			query.selects.push({
+				sql: `${require_queries_sql_keywords.kqDot(alias, "_")} as ${require_queries_sql_keywords.kq(relationAlias)}`,
+				aliases: [alias],
+				bindings: []
+			});
+			query.tables.push(join);
+		}
+		return (rows, entities) => {
+			for (let i = 0; i < entities.length; i++) {
+				const parent = entities[i];
+				for (const { relationAlias, hydrator } of joins) hydrator(parent, parent, readRowValue(rows, i, relationAlias) ?? []);
+			}
+		};
+	}
+	getPreloadJoins(meta, root, query) {
+		const assigner = new require_queries_sql_AliasAssigner.AliasAssigner(query);
+		const alias = require_queries_find_QueryParser.getTables(query)[0].alias;
+		return calcLateralJoins(assigner, {
+			tree: root,
+			alias,
+			meta
+		}, root, alias, meta).map((join) => {
+			return {
+				selects: [{
+					value: require_queries_sql_keywords.kqDot(join.alias, "_"),
+					as: join.relationAlias
+				}],
+				join: join.join,
+				hydrator: (rows, entities) => {
+					for (let i = 0; i < entities.length; i++) {
+						const parent = entities[i];
+						join.hydrator(parent, parent, readRowValue(rows, i, join.relationAlias) ?? []);
+					}
+				}
+			};
+		});
+	}
+};
+/**
+* For a given hint tree `hint`, finds all SQL-able relations and preloads them.
+*
+* Specifically we use `json_agg` & `json_build_array` to `CROSS LATERAL JOIN`
+* children/grand children back as arbitrarily-deeply nested arrays, and then
+* stash the results in the `EntityManager` `joinLoadedRelations` cache, which
+* each join-instrumented relation will check before making its SQL calls.
+*
+* https://sqlfum.pt/?n=60&indent=2&spaces=1&simplify=1&align=0&case=lower&sql=c2VsZWN0IGEuaWQsIGIuXyBhcyBiLCBjMS5fIGFzIGMxLCBhMS5fIGFzIGExIGZyb20gYXV0aG9ycyBhIGNyb3NzIGpvaW4gbGF0ZXJhbCAoIHNlbGVjdCBqc29uX2FnZyhqc29uX2J1aWxkX2FycmF5KGIuaWQsIGIudGl0bGUsIGIuIm9yZGVyIiwgYi5kZWxldGVkX2F0LCBiLmNyZWF0ZWRfYXQsIGIudXBkYXRlZF9hdCwgYi5hdXRob3JfaWQsIGJyLl8pKSBhcyBfIGZyb20gYm9va3MgYiBjcm9zcyBqb2luIGxhdGVyYWwgKCBzZWxlY3QganNvbl9hZ2coanNvbl9idWlsZF9hcnJheShici5pZCwgYnIucmF0aW5nLCBici5pc19wdWJsaWMsIGJyLmlzX3Rlc3QsIGJyLmNyZWF0ZWRfYXQsIGJyLnVwZGF0ZWRfYXQsIGJyLmJvb2tfaWQsIGMuXykpIGFzIF8gZnJvbSBib29rX3Jldmlld3MgYnIgY3Jvc3Mgam9pbiBsYXRlcmFsICggc2VsZWN0IGpzb25fYWdnKGpzb25fYnVpbGRfYXJyYXkoYy5pZCwgYy50ZXh0LCBjLmNyZWF0ZWRfYXQsIGMudXBkYXRlZF9hdCwgYy51c2VyX2lkLCBjLnBhcmVudF9hdXRob3JfaWQsIGMucGFyZW50X2Jvb2tfaWQsIGMucGFyZW50X2Jvb2tfcmV2aWV3X2lkLCBjLnBhcmVudF9wdWJsaXNoZXJfaWQpKSBhcyBfIGZyb20gY29tbWVudHMgYyB3aGVyZSBjLnBhcmVudF9ib29rX3Jldmlld19pZCA9IGJyLmlkICkgYyB3aGVyZSBici5ib29rX2lkID0gYi5pZCApIGJyIHdoZXJlIGIuYXV0aG9yX2lkID0gYS5pZCApIGIgY3Jvc3Mgam9pbiBsYXRlcmFsICggc2VsZWN0IGpzb25fYWdnKGpzb25fYnVpbGRfYXJyYXkoYzEuaWQsIGMxLnRleHQsIGMxLmNyZWF0ZWRfYXQsIGMxLnVwZGF0ZWRfYXQsIGMxLnVzZXJfaWQsIGMxLnBhcmVudF9hdXRob3JfaWQsIGMxLnBhcmVudF9ib29rX2lkLCBjMS5wYXJlbnRfYm9va19yZXZpZXdfaWQsIGMxLnBhcmVudF9wdWJsaXNoZXJfaWQpKSBhcyBfIGZyb20gY29tbWVudHMgYzEgd2hlcmUgYzEucGFyZW50X2F1dGhvcl9pZCA9IGEuaWQgKSBjMSBjcm9zcyBqb2luIGxhdGVyYWwgKCBzZWxlY3QganNvbl9hZ2coanNvbl9idWlsZF9hcnJheShhMS5pZCwgYTEuZmlyc3RfbmFtZSwgYTEubGFzdF9uYW1lLCBhMS5zc24sIGExLmluaXRpYWxzLCBhMS5udW1iZXJfb2ZfYm9va3MsIGExLmJvb2tfY29tbWVudHMsIGExLmlzX3BvcHVsYXIsIGExLmFnZSwgYTEuZ3JhZHVhdGVkLCBhMS5uaWNrX25hbWVzLCBhMS53YXNfZXZlcl9wb3B1bGFyLCBhMS5hZGRyZXNzLCBhMS5idXNpbmVzc19hZGRyZXNzLCBhMS5xdW90ZXMsIGExLm51bWJlcl9vZl9hdG9tcywgYTEuZGVsZXRlZF9hdCwgYTEubnVtYmVyX29mX3B1YmxpY19yZXZpZXdzLCBhMS4ibnVtYmVyT2ZQdWJsaWNSZXZpZXdzMiIsIGExLnRhZ3Nfb2ZfYWxsX2Jvb2tzLCBhMS5jcmVhdGVkX2F0LCBhMS51cGRhdGVkX2F0LCBhMS5mYXZvcml0ZV9zaGFwZSwgYTEuZmF2b3JpdGVfY29sb3JzLCBhMS5tZW50b3JfaWQsIGExLmN1cnJlbnRfZHJhZnRfYm9va19pZCwgYTEuZmF2b3JpdGVfYm9va19pZCwgYTEucHVibGlzaGVyX2lkKSkgYXMgXyBmcm9tIGF1dGhvcnMgYTEgd2hlcmUgYTEuaWQgPSBhLm1lbnRvcl9pZCApIGExIHdoZXJlIGEuaWQgPSAxOw%3D%3D
+*/
+/**
+* Given a `parent` like Author, and a hint of `{ books: ..., comments: ... }`, create `CROSS JOIN LATERAL`s
+* that will pull in the `books` & `comments` children.
+*/
+function calcLateralJoins(assigner, root, tree, parentAlias, parentMeta, pathPrefix = "") {
+	const results = [];
+	Object.entries(tree.hints).forEach(([key, subTree]) => {
+		const field = parentMeta.allFields[key];
+		if (field && require_preloading_canPreload.canPreload(parentMeta, field)) {
+			if (field.kind === "m2mEnum") {
+				results.push(calcEnumLateralJoin(assigner, root, subTree, parentAlias, field, key, pathPrefix));
+				return;
+			}
+			const otherMeta = field.otherMetadata();
+			const otherField = otherMeta.allFields[field.otherFieldName];
+			const otherAlias = `_${assigner.getAlias(otherMeta.tableName)}`;
+			const pathKey = key.toLowerCase();
+			const relationAlias = `_${assigner.getLiteralAlias(`${pathPrefix}${pathKey}`)}`;
+			const subJoins = calcLateralJoins(assigner, root, subTree, otherAlias, otherMeta, `${pathPrefix}${pathKey}_`);
+			const columns = Object.values(otherMeta.allFields).filter((f) => f.serde && !(f.kind === "primitive" && f.lazy)).flatMap((f) => f.serde.columns);
+			const selects = [...columns.map((c) => require_queries_sql_keywords.kqDot(otherAlias, c.columnName)), ...subJoins.map((sb) => require_queries_sql_keywords.kqDot(sb.alias, "_"))];
+			const aliasMaybeSuffix = require_queries_sql_keywords.kq(`${parentAlias}${field.aliasSuffix}`);
+			const cb = new require_queries_ConditionBuilder.ConditionBuilder();
+			let m2mTable;
+			let m2mAlias;
+			if (otherField.kind === "m2o") cb.addRawCondition({
+				aliases: [otherAlias, parentAlias],
+				condition: `${require_queries_sql_keywords.kqDot(otherAlias, otherField.serde.columns[0].columnName)} = ${require_queries_sql_keywords.kqDot(parentAlias, "id")}`,
+				pruneable: true
+			});
+			else if (otherField.kind === "poly") {
+				const comp = otherField.components.find((c) => parentMeta.cstr === c.otherMetadata().cstr) ?? require_utils.fail(`No component found for ${field.fieldName} -> ${otherField.fieldName}`);
+				cb.addRawCondition({
+					aliases: [otherAlias, parentAlias],
+					condition: `${require_queries_sql_keywords.kqDot(otherAlias, comp.columnName)} = ${require_queries_sql_keywords.kqDot(parentAlias, "id")}`,
+					pruneable: true
+				});
+			} else if (otherField.kind === "o2m" || otherField.kind === "lo2m") cb.addRawCondition({
+				aliases: [otherAlias, aliasMaybeSuffix],
+				condition: `${require_queries_sql_keywords.kqDot(otherAlias, "id")} = ${aliasMaybeSuffix}.${require_queries_sql_keywords.kq(field.serde.columns[0].columnName)}`,
+				pruneable: true
+			});
+			else if (otherField.kind === "o2o") cb.addRawCondition({
+				aliases: [otherAlias, aliasMaybeSuffix],
+				condition: `${require_queries_sql_keywords.kqDot(otherAlias, "id")} = ${aliasMaybeSuffix}.${require_queries_sql_keywords.kq(field.serde.columns[0].columnName)}`,
+				pruneable: true
+			});
+			else if (otherField.kind === "m2m") {
+				m2mAlias = assigner.getAlias(otherField.joinTableName);
+				if (otherField.hasJoinTableId) selects.unshift(require_queries_sql_keywords.kqDot(m2mAlias, "id"));
+				m2mTable = {
+					join: "inner",
+					table: otherField.joinTableName,
+					alias: m2mAlias,
+					col1: require_queries_sql_keywords.kqDot(parentAlias, "id"),
+					col2: require_queries_sql_keywords.kqDot(m2mAlias, otherField.columnNames[1])
+				};
+				cb.addRawCondition({
+					aliases: [m2mAlias, otherAlias],
+					condition: `${require_queries_sql_keywords.kqDot(m2mAlias, otherField.columnNames[0])} = ${require_queries_sql_keywords.kqDot(otherAlias, "id")}`,
+					pruneable: true
+				});
+			} else throw new Error(`Unsupported otherField.kind ${otherField.kind}`);
+			if (subTree.entities.size !== root.tree.entities.size) cb.addRawCondition({
+				aliases: [root.alias],
+				condition: `${require_queries_sql_keywords.kqDot(root.alias, "id")} = ANY(?)`,
+				bindings: [[...subTree.entities].filter((e) => typeof e === "string" || !e.isNewEntity).map((e) => require_keys.keyToNumber(root.meta, typeof e === "string" ? e : e.id))],
+				pruneable: true
+			});
+			const orderBy = otherField.kind === "m2m" && !otherField.hasJoinTableId ? `${require_queries_sql_keywords.kq(m2mAlias)}.${require_queries_sql_keywords.kq(otherField.columnNames[0])}` : `${require_queries_sql_keywords.kq(m2mAlias ?? otherAlias)}.id`;
+			const join = {
+				join: "lateral",
+				alias: otherAlias,
+				fromAlias: "unset",
+				table: otherMeta.tableName,
+				query: {
+					selects: [`json_agg(json_build_array(${selects.join(", ")}) order by ${orderBy}) as _`],
+					tables: [
+						{
+							join: "primary",
+							table: otherMeta.tableName,
+							alias: otherAlias
+						},
+						...m2mTable ? [m2mTable] : [],
+						...subJoins.map((sj) => sj.join)
+					],
+					condition: cb.toExpressionFilter(),
+					orderBys: []
+				}
+			};
+			const columnNames = columns.map((c) => c.columnName);
+			const m2mOffset = field.kind === "m2m" && field.hasJoinTableId ? 1 : 0;
+			const hydrator = (root, parent, arrays) => {
+				const { em } = root;
+				if (subTree.entitiesKind === "instances" && !subTree.entities.has(root)) return;
+				if (subTree.entitiesKind === "ids" && !subTree.entities.has(root.idTagged)) return;
+				const children = arrays.map((array) => {
+					const taggedId = require_keys.keyToTaggedId(otherMeta, array[m2mOffset]);
+					const row = {};
+					for (let i = 0; i < columns.length; i++) row[columnNames[i]] = columns[i].mapFromJsonAgg(array[m2mOffset + i]);
+					const entity = em.findExistingInstance(taggedId) ?? em.hydrate(otherMeta.cstr, [row], { overwriteExisting: false })[0];
+					if (field.kind === "m2m") {
+						const m2m = parent[key];
+						require_EntityManager.getEmInternalApi(em).joinRows(m2m).addPreloadedRow(m2m, field.hasJoinTableId ? array[0] : void 0, parent, entity);
+					}
+					subJoins.forEach((sub, i) => {
+						sub.hydrator(root, entity, array[m2mOffset + columns.length + i] ?? []);
+					});
+					return entity;
+				});
+				require_EntityManager.getEmInternalApi(em).setPreloadedRelation(parent.idTagged, key, children);
+			};
+			results.push({
+				alias: otherAlias,
+				relationAlias,
+				join,
+				hydrator
+			});
+		}
+	});
+	return results;
+}
+/**
+* Builds the `CROSS JOIN LATERAL` that aggregates an enum-m2m join table (e.g. `publisher_logo_colors`)
+* into a json array of enum ids, e.g. `[[1], [3]]` (or `[[1, id], [3, id]]` for id-ful join tables).
+*/
+function calcEnumLateralJoin(assigner, root, subTree, parentAlias, field, key, pathPrefix) {
+	const [entityColumn, enumColumn] = field.columnNames;
+	const jtAlias = `_${assigner.getAlias(field.joinTableName)}`;
+	const relationAlias = `_${assigner.getLiteralAlias(`${pathPrefix}${key.toLowerCase()}`)}`;
+	const parts = [require_queries_sql_keywords.kqDot(jtAlias, enumColumn)];
+	if (field.hasJoinTableId) parts.push(require_queries_sql_keywords.kqDot(jtAlias, "id"));
+	const cb = new require_queries_ConditionBuilder.ConditionBuilder();
+	cb.addRawCondition({
+		aliases: [jtAlias, parentAlias],
+		condition: `${require_queries_sql_keywords.kqDot(jtAlias, entityColumn)} = ${require_queries_sql_keywords.kqDot(parentAlias, "id")}`,
+		pruneable: true
+	});
+	if (subTree.entities.size !== root.tree.entities.size) cb.addRawCondition({
+		aliases: [root.alias],
+		condition: `${require_queries_sql_keywords.kqDot(root.alias, "id")} = ANY(?)`,
+		bindings: [[...subTree.entities].filter((e) => typeof e === "string" || !e.isNewEntity).map((e) => require_keys.keyToNumber(root.meta, typeof e === "string" ? e : e.id))],
+		pruneable: true
+	});
+	const orderBy = `${require_queries_sql_keywords.kq(jtAlias)}.${require_queries_sql_keywords.kq(field.hasJoinTableId ? "id" : enumColumn)}`;
+	const join = {
+		join: "lateral",
+		alias: jtAlias,
+		fromAlias: "unset",
+		table: field.joinTableName,
+		query: {
+			selects: [`json_agg(json_build_array(${parts.join(", ")}) order by ${orderBy}) as _`],
+			tables: [{
+				join: "primary",
+				table: field.joinTableName,
+				alias: jtAlias
+			}],
+			condition: cb.toExpressionFilter(),
+			orderBys: []
+		}
+	};
+	const hydrator = (root, parent, arrays) => {
+		const { em } = root;
+		if (subTree.entitiesKind === "instances" && !subTree.entities.has(root)) return;
+		if (subTree.entitiesKind === "ids" && !subTree.entities.has(root.idTagged)) return;
+		const like = {
+			entity: parent,
+			joinTableName: field.joinTableName,
+			columnName: entityColumn,
+			otherColumnName: enumColumn,
+			fieldName: key,
+			meta: require_EntityMetadata.getMetadataForField(require_EntityMetadata.getMetadata(parent), key),
+			otherEnum: field.enumDetailType,
+			hasJoinTableId: field.hasJoinTableId
+		};
+		const api = require_EntityManager.getEmInternalApi(em);
+		const joinRows = api.joinRows(like);
+		const codes = [];
+		for (const array of arrays) {
+			const enumId = array[0];
+			joinRows.addPreloadedRow(like, field.hasJoinTableId ? array[1] : void 0, parent, enumId);
+			codes.push(field.enumDetailType.findById(enumId).code);
+		}
+		api.setPreloadedRelation(parent.idTagged, key, codes);
+	};
+	return {
+		alias: jtAlias,
+		relationAlias,
+		join,
+		hydrator
+	};
+}
+/** Reads one column from either classic POJO rows or a lazy `RowData` result. */
+function readRowValue(rows, rowIndex, columnName) {
+	return Array.isArray(rows) ? rows[rowIndex][columnName] : rows.get(rowIndex, columnName);
+}
+//#endregion
+exports.JsonAggregatePreloader = JsonAggregatePreloader;
+
+//# sourceMappingURL=JsonAggregatePreloader.cjs.map

package/build/preloading/JsonAggregatePreloader.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonAggregatePreloader.cjs","names":["partitionHint","AliasAssigner","getTables","kqDot","kq","canPreload","ConditionBuilder","fail","keyToNumber","keyToTaggedId","getMetadataForField","getMetadata","getEmInternalApi"],"sources":["../../src/preloading/JsonAggregatePreloader.ts"],"sourcesContent":["import { type Entity } from \"src/Entity.ts\";\nimport { getEmInternalApi } from \"src/EntityManager.ts\";\nimport { type EntityMetadata, type ManyToManyEnumField, getMetadata, getMetadataForField } from \"src/EntityMetadata.ts\";\nimport type { ManyToManyLike } from \"src/flush/JoinRows.ts\";\nimport { keyToNumber, keyToTaggedId } from \"src/keys.ts\";\nimport type { EntityOrId, HintNode } from \"src/loading/HintTree.ts\";\nimport type { LoadHint, NestedLoadHint } from \"src/loading/loadHints.ts\";\nimport { type JoinResult, type PreloadHydrator, type PreloadPlugin } from \"src/plugins/PreloadPlugin.ts\";\nimport { canPreload } from \"src/preloading/canPreload.ts\";\nimport { partitionHint } from \"src/preloading/partitionHint.ts\";\nimport { ConditionBuilder } from \"src/queries/ConditionBuilder.ts\";\nimport {\n  type JoinTable,\n  type LateralJoinTable,\n  type ParsedFindQuery,\n  getTables,\n} from \"src/queries/find/QueryParser.ts\";\nimport { AliasAssigner } from \"src/queries/sql/AliasAssigner.ts\";\nimport { kq, kqDot } from \"src/queries/sql/keywords.ts\";\nimport { type RowData } from \"src/RowData.ts\";\nimport { fail } from \"src/utils.ts\";\n\n/**\n * A PreloadPlugin implementation that uses `CROSS LATERAL JOIN` and `json_aggregate`\n * to preload/reduce a subtree of data while still being a single row of data.\n */\nexport class JsonAggregatePreloader implements PreloadPlugin {\n  partitionHint(\n    meta: EntityMetadata | undefined,\n    hint: LoadHint<any>,\n  ): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined] {\n    return partitionHint(meta, hint);\n  }\n\n  addPreloading<T extends Entity>(\n    meta: EntityMetadata,\n    root: HintNode<T>,\n    query: ParsedFindQuery,\n  ): PreloadHydrator | undefined {\n    const assigner = new AliasAssigner(query);\n\n    // Get the existing primary alias\n    const alias = getTables(query)[0].alias;\n    const joins = calcLateralJoins(assigner, { tree: root, alias, meta }, root, alias, meta);\n    // If there are no sql-based preload in the hints, just return\n    if (joins.length === 0) return undefined;\n\n    // Include the aggregate `_b1._ as _prequel`, `_c._ as _randomComment`\n    for (const { alias, relationAlias, join } of joins) {\n      query.selects.push({\n        sql: `${kqDot(alias, \"_\")} as ${kq(relationAlias)}`,\n        aliases: [alias],\n        bindings: [],\n      });\n      query.tables.push(join);\n    }\n\n    return (rows, entities) => {\n      for (let i = 0; i < entities.length; i++) {\n        const parent = entities[i];\n        for (const { relationAlias, hydrator } of joins) {\n          hydrator(parent, parent, readRowValue(rows, i, relationAlias) ?? []);\n        }\n      }\n    };\n  }\n\n  getPreloadJoins<T extends Entity>(meta: EntityMetadata, root: HintNode<T>, query: ParsedFindQuery): JoinResult[] {\n    const assigner = new AliasAssigner(query);\n\n    // Get the existing primary alias\n    const alias = getTables(query)[0].alias;\n    const joins = calcLateralJoins(assigner, { tree: root, alias, meta }, root, alias, meta);\n    // If there are no sql-based preload in the hints, just return\n\n    // Adapt our json aggregate joins to the higher-level JoinResult\n    return joins.map((join) => {\n      return {\n        selects: [{ value: kqDot(join.alias, \"_\"), as: join.relationAlias }],\n        join: join.join,\n        hydrator: (rows, entities) => {\n          for (let i = 0; i < entities.length; i++) {\n            const parent = entities[i];\n            join.hydrator(parent, parent, readRowValue(rows, i, join.relationAlias) ?? []);\n          }\n        },\n      };\n    });\n  }\n}\n\n/** Decodes an array-of-arrays of children entries, and stores them the `parent`'s relation. */\ntype AggregateJsonHydrator = (root: Entity, parent: Entity, arrays: unknown[][]) => void;\n\n/**\n * For a given hint tree `hint`, finds all SQL-able relations and preloads them.\n *\n * Specifically we use `json_agg` & `json_build_array` to `CROSS LATERAL JOIN`\n * children/grand children back as arbitrarily-deeply nested arrays, and then\n * stash the results in the `EntityManager` `joinLoadedRelations` cache, which\n * each join-instrumented relation will check before making its SQL calls.\n *\n * https://sqlfum.pt/?n=60&indent=2&spaces=1&simplify=1&align=0&case=lower&sql=c2VsZWN0IGEuaWQsIGIuXyBhcyBiLCBjMS5fIGFzIGMxLCBhMS5fIGFzIGExIGZyb20gYXV0aG9ycyBhIGNyb3NzIGpvaW4gbGF0ZXJhbCAoIHNlbGVjdCBqc29uX2FnZyhqc29uX2J1aWxkX2FycmF5KGIuaWQsIGIudGl0bGUsIGIuIm9yZGVyIiwgYi5kZWxldGVkX2F0LCBiLmNyZWF0ZWRfYXQsIGIudXBkYXRlZF9hdCwgYi5hdXRob3JfaWQsIGJyLl8pKSBhcyBfIGZyb20gYm9va3MgYiBjcm9zcyBqb2luIGxhdGVyYWwgKCBzZWxlY3QganNvbl9hZ2coanNvbl9idWlsZF9hcnJheShici5pZCwgYnIucmF0aW5nLCBici5pc19wdWJsaWMsIGJyLmlzX3Rlc3QsIGJyLmNyZWF0ZWRfYXQsIGJyLnVwZGF0ZWRfYXQsIGJyLmJvb2tfaWQsIGMuXykpIGFzIF8gZnJvbSBib29rX3Jldmlld3MgYnIgY3Jvc3Mgam9pbiBsYXRlcmFsICggc2VsZWN0IGpzb25fYWdnKGpzb25fYnVpbGRfYXJyYXkoYy5pZCwgYy50ZXh0LCBjLmNyZWF0ZWRfYXQsIGMudXBkYXRlZF9hdCwgYy51c2VyX2lkLCBjLnBhcmVudF9hdXRob3JfaWQsIGMucGFyZW50X2Jvb2tfaWQsIGMucGFyZW50X2Jvb2tfcmV2aWV3X2lkLCBjLnBhcmVudF9wdWJsaXNoZXJfaWQpKSBhcyBfIGZyb20gY29tbWVudHMgYyB3aGVyZSBjLnBhcmVudF9ib29rX3Jldmlld19pZCA9IGJyLmlkICkgYyB3aGVyZSBici5ib29rX2lkID0gYi5pZCApIGJyIHdoZXJlIGIuYXV0aG9yX2lkID0gYS5pZCApIGIgY3Jvc3Mgam9pbiBsYXRlcmFsICggc2VsZWN0IGpzb25fYWdnKGpzb25fYnVpbGRfYXJyYXkoYzEuaWQsIGMxLnRleHQsIGMxLmNyZWF0ZWRfYXQsIGMxLnVwZGF0ZWRfYXQsIGMxLnVzZXJfaWQsIGMxLnBhcmVudF9hdXRob3JfaWQsIGMxLnBhcmVudF9ib29rX2lkLCBjMS5wYXJlbnRfYm9va19yZXZpZXdfaWQsIGMxLnBhcmVudF9wdWJsaXNoZXJfaWQpKSBhcyBfIGZyb20gY29tbWVudHMgYzEgd2hlcmUgYzEucGFyZW50X2F1dGhvcl9pZCA9IGEuaWQgKSBjMSBjcm9zcyBqb2luIGxhdGVyYWwgKCBzZWxlY3QganNvbl9hZ2coanNvbl9idWlsZF9hcnJheShhMS5pZCwgYTEuZmlyc3RfbmFtZSwgYTEubGFzdF9uYW1lLCBhMS5zc24sIGExLmluaXRpYWxzLCBhMS5udW1iZXJfb2ZfYm9va3MsIGExLmJvb2tfY29tbWVudHMsIGExLmlzX3BvcHVsYXIsIGExLmFnZSwgYTEuZ3JhZHVhdGVkLCBhMS5uaWNrX25hbWVzLCBhMS53YXNfZXZlcl9wb3B1bGFyLCBhMS5hZGRyZXNzLCBhMS5idXNpbmVzc19hZGRyZXNzLCBhMS5xdW90ZXMsIGExLm51bWJlcl9vZl9hdG9tcywgYTEuZGVsZXRlZF9hdCwgYTEubnVtYmVyX29mX3B1YmxpY19yZXZpZXdzLCBhMS4ibnVtYmVyT2ZQdWJsaWNSZXZpZXdzMiIsIGExLnRhZ3Nfb2ZfYWxsX2Jvb2tzLCBhMS5jcmVhdGVkX2F0LCBhMS51cGRhdGVkX2F0LCBhMS5mYXZvcml0ZV9zaGFwZSwgYTEuZmF2b3JpdGVfY29sb3JzLCBhMS5tZW50b3JfaWQsIGExLmN1cnJlbnRfZHJhZnRfYm9va19pZCwgYTEuZmF2b3JpdGVfYm9va19pZCwgYTEucHVibGlzaGVyX2lkKSkgYXMgXyBmcm9tIGF1dGhvcnMgYTEgd2hlcmUgYTEuaWQgPSBhLm1lbnRvcl9pZCApIGExIHdoZXJlIGEuaWQgPSAxOw%3D%3D\n */\n\n/**\n * Given a `parent` like Author, and a hint of `{ books: ..., comments: ... }`, create `CROSS JOIN LATERAL`s\n * that will pull in the `books` & `comments` children.\n */\nfunction calcLateralJoins<I extends EntityOrId>(\n  assigner: AliasAssigner,\n  root: { tree: HintNode<I>; alias: string; meta: EntityMetadata },\n  tree: HintNode<I>,\n  parentAlias: string,\n  parentMeta: EntityMetadata,\n  pathPrefix: string = \"\",\n): AggregateJoinResult[] {\n  const results: AggregateJoinResult[] = [];\n\n  // Join in SQL-able hints from parent\n  Object.entries(tree.hints).forEach(([key, subTree]) => {\n    const field = parentMeta.allFields[key];\n    // AsyncProperties don't have fields, which is fine, skip for now...\n    if (field && canPreload(parentMeta, field)) {\n      // Enum m2ms have no \"other\" entity to join/hydrate; just aggregate the join table's enum ids.\n      if (field.kind === \"m2mEnum\") {\n        results.push(calcEnumLateralJoin(assigner, root, subTree, parentAlias, field, key, pathPrefix));\n        return;\n      }\n      const otherMeta = field.otherMetadata();\n      const otherField = otherMeta.allFields[field.otherFieldName];\n\n      // Short table alias for column refs inside the subquery, e.g. `_b1`\n      const otherAlias = `_${assigner.getAlias(otherMeta.tableName)}`;\n      // Readable path-based column alias for the outer AS clause, e.g. `_books_reviews`\n      const pathKey = key.toLowerCase();\n      const relationAlias = `_${assigner.getLiteralAlias(`${pathPrefix}${pathKey}`)}`;\n\n      // Do the recursion up-front, so we can work it into our own join/hydrator\n      const subJoins = calcLateralJoins(assigner, root, subTree, otherAlias, otherMeta, `${pathPrefix}${pathKey}_`);\n\n      // Get all fields with serdes and flatten out the columns, skipping `lazy` columns (fetched on-demand)\n      const columns = Object.values(otherMeta.allFields)\n        .filter((f) => f.serde && !(f.kind === \"primitive\" && f.lazy))\n        .flatMap((f) => f.serde!.columns);\n      const selects = [\n        ...columns.map((c) => kqDot(otherAlias, c.columnName)),\n        // We eventually need to handle parent types/subtypes here...\n        // Combine any grandchilden\n        ...subJoins.map((sb) => kqDot(sb.alias, \"_\")),\n      ];\n\n      const aliasMaybeSuffix = kq(`${parentAlias}${field.aliasSuffix}`);\n\n      const cb = new ConditionBuilder();\n      let m2mTable: JoinTable | undefined;\n      let m2mAlias: string | undefined;\n      if (otherField.kind === \"m2o\") {\n        cb.addRawCondition({\n          aliases: [otherAlias, parentAlias],\n          condition: `${kqDot(otherAlias, otherField.serde.columns[0].columnName)} = ${kqDot(parentAlias, \"id\")}`,\n          pruneable: true,\n        });\n      } else if (otherField.kind === \"poly\") {\n        // Get the component that points to us\n        // const comp = otherField.components.find((c) => getAllMetas(parentMeta).some((m) => m.cstr === c.otherMetadata().cstr)) ??\n        const comp =\n          otherField.components.find((c) => parentMeta.cstr === c.otherMetadata().cstr) ??\n          fail(`No component found for ${field.fieldName} -> ${otherField.fieldName}`);\n        cb.addRawCondition({\n          aliases: [otherAlias, parentAlias],\n          condition: `${kqDot(otherAlias, comp.columnName)} = ${kqDot(parentAlias, \"id\")}`,\n          pruneable: true,\n        });\n      } else if (otherField.kind === \"o2m\" || otherField.kind === \"lo2m\") {\n        cb.addRawCondition({\n          aliases: [otherAlias, aliasMaybeSuffix],\n          condition: `${kqDot(otherAlias, \"id\")} = ${aliasMaybeSuffix}.${kq(field.serde!.columns[0].columnName)}`,\n          pruneable: true,\n        });\n      } else if (otherField.kind === \"o2o\") {\n        cb.addRawCondition({\n          aliases: [otherAlias, aliasMaybeSuffix],\n          condition: `${kqDot(otherAlias, \"id\")} = ${aliasMaybeSuffix}.${kq(field.serde!.columns[0].columnName)}`,\n          pruneable: true,\n        });\n      } else if (otherField.kind === \"m2m\") {\n        m2mAlias = assigner.getAlias(otherField.joinTableName);\n        // Get the m2m row's id to track in JoinRows; id-less tables have no surrogate id.\n        if (otherField.hasJoinTableId) selects.unshift(kqDot(m2mAlias, \"id\"));\n        m2mTable = {\n          join: \"inner\",\n          table: otherField.joinTableName,\n          alias: m2mAlias,\n          col1: kqDot(parentAlias, \"id\"),\n          col2: kqDot(m2mAlias, otherField.columnNames[1]),\n        };\n        cb.addRawCondition({\n          aliases: [m2mAlias, otherAlias],\n          condition: `${kqDot(m2mAlias, otherField.columnNames[0])} = ${kqDot(otherAlias, \"id\")}`,\n          pruneable: true,\n        });\n      } else {\n        throw new Error(`Unsupported otherField.kind ${otherField.kind}`);\n      }\n\n      const needsSubSelect = subTree.entities.size !== root.tree.entities.size;\n      if (needsSubSelect) {\n        cb.addRawCondition({\n          aliases: [root.alias],\n          condition: `${kqDot(root.alias, \"id\")} = ANY(?)`,\n          bindings: [\n            [...subTree.entities]\n              .filter((e) => typeof e === \"string\" || !e.isNewEntity)\n              .map((e) => keyToNumber(root.meta, typeof e === \"string\" ? e : e.id)),\n          ],\n          pruneable: true,\n        });\n      }\n\n      // For m2m, order by the join-row's id so preloaded results match the order the lazy batch\n      // loader returns (which orders by join-row id). Id-less join tables have no surrogate id,\n      // so order by the other entity's FK column (matching the lazy loader & getOthers). Otherwise,\n      // order by the target entity's id.\n      const orderBy =\n        otherField.kind === \"m2m\" && !otherField.hasJoinTableId\n          ? `${kq(m2mAlias!)}.${kq(otherField.columnNames[0])}`\n          : `${kq(m2mAlias ?? otherAlias)}.id`;\n\n      const join: LateralJoinTable = {\n        join: \"lateral\",\n        alias: otherAlias,\n        // Do we need to say which alias we're coming from, to avoid having it pruned?\n        // ...maybe not because preloading is always on the primary table?\n        fromAlias: \"unset\",\n        table: otherMeta.tableName,\n        query: {\n          selects: [`json_agg(json_build_array(${selects.join(\", \")}) order by ${orderBy}) as _`],\n          tables: [\n            { join: \"primary\", table: otherMeta.tableName, alias: otherAlias },\n            ...(m2mTable ? [m2mTable] : []),\n            ...subJoins.map((sj) => sj.join),\n          ],\n          condition: cb.toExpressionFilter(),\n          orderBys: [],\n        },\n      };\n\n      // Pre-compute column names so we don't re-read them per entity\n      const columnNames = columns.map((c) => c.columnName);\n      // If we've snuck the m2m row id into the json array, ignore it (id-less tables have no id)\n      const m2mOffset = field.kind === \"m2m\" && field.hasJoinTableId ? 1 : 0;\n\n      const hydrator: AggregateJsonHydrator = (root, parent, arrays) => {\n        const { em } = root;\n\n        // If we had overlapping load hints, i.e. `author.books` for [a1, a2] and `author.comments` for [a1], and\n        // we're processing the arrays of comments, but for a root author like `a2` that didn't ask for our load\n        // hint, then skip it to keep the relation unloaded.\n        if (subTree.entitiesKind === \"instances\" && !subTree.entities.has(root as any)) return;\n        if (subTree.entitiesKind === \"ids\" && !subTree.entities.has(root.idTagged as any)) return;\n\n        // We get back an array of [[1, title], [2, title], [3, title]]\n        const children = arrays.map((array) => {\n          const taggedId = keyToTaggedId(otherMeta, array[m2mOffset] as any)!;\n          const row: Record<string, any> = {};\n          for (let i = 0; i < columns.length; i++) {\n            row[columnNames[i]] = columns[i].mapFromJsonAgg(array[m2mOffset + i]);\n          }\n          const entity =\n            em.findExistingInstance<Entity>(taggedId) ??\n            (em.hydrate(otherMeta.cstr, [row], { overwriteExisting: false }) as Entity[])[0];\n          // Tell the internal JoinRow booking-keeping about this m2m row\n          if (field.kind === \"m2m\") {\n            // TODO This `addExisting` needs to be pulled up, out of the `arrays.map`, so we can do a `loadRows`-ish\n            // call that passes all now-known m2m rows into JoinRows as a single list, so that it can mark any\n            // deleted-from-under-us m2m rows as deleted.\n            const m2m = (parent as any)[key];\n            getEmInternalApi(em)\n              .joinRows(m2m)\n              .addPreloadedRow(m2m, field.hasJoinTableId ? (array[0] as any) : undefined, parent, entity);\n          }\n          // Within each child, look for grandchildren\n          subJoins.forEach((sub, i) => {\n            // array[i] could be null if there are no grandchildren, but still call `sub` to\n            // process it so that we store the empty array into the em.joinLoadedRelations, to\n            // avoid the relation.load method later doing a SQL for rows we know are not there.\n            sub.hydrator(root, entity, (array[m2mOffset + columns.length + i] as any) ?? []);\n          });\n          return entity;\n        });\n        // Cache the entities so `.load`s will see them\n        getEmInternalApi(em).setPreloadedRelation(parent.idTagged, key, children);\n      };\n\n      results.push({ alias: otherAlias, relationAlias, join, hydrator });\n    }\n  });\n\n  return results;\n}\n\n/**\n * Builds the `CROSS JOIN LATERAL` that aggregates an enum-m2m join table (e.g. `publisher_logo_colors`)\n * into a json array of enum ids, e.g. `[[1], [3]]` (or `[[1, id], [3, id]]` for id-ful join tables).\n */\nfunction calcEnumLateralJoin<I extends EntityOrId>(\n  assigner: AliasAssigner,\n  root: { tree: HintNode<I>; alias: string; meta: EntityMetadata },\n  subTree: HintNode<I>,\n  parentAlias: string,\n  field: ManyToManyEnumField,\n  key: string,\n  pathPrefix: string,\n): AggregateJoinResult {\n  const [entityColumn, enumColumn] = field.columnNames;\n  const jtAlias = `_${assigner.getAlias(field.joinTableName)}`;\n  const relationAlias = `_${assigner.getLiteralAlias(`${pathPrefix}${key.toLowerCase()}`)}`;\n\n  const parts = [kqDot(jtAlias, enumColumn)];\n  if (field.hasJoinTableId) parts.push(kqDot(jtAlias, \"id\"));\n\n  const cb = new ConditionBuilder();\n  cb.addRawCondition({\n    aliases: [jtAlias, parentAlias],\n    condition: `${kqDot(jtAlias, entityColumn)} = ${kqDot(parentAlias, \"id\")}`,\n    pruneable: true,\n  });\n\n  const needsSubSelect = subTree.entities.size !== root.tree.entities.size;\n  if (needsSubSelect) {\n    cb.addRawCondition({\n      aliases: [root.alias],\n      condition: `${kqDot(root.alias, \"id\")} = ANY(?)`,\n      bindings: [\n        [...subTree.entities]\n          .filter((e) => typeof e === \"string\" || !e.isNewEntity)\n          .map((e) => keyToNumber(root.meta, typeof e === \"string\" ? e : e.id)),\n      ],\n      pruneable: true,\n    });\n  }\n\n  const orderBy = `${kq(jtAlias)}.${kq(field.hasJoinTableId ? \"id\" : enumColumn)}`;\n  const join: LateralJoinTable = {\n    join: \"lateral\",\n    alias: jtAlias,\n    fromAlias: \"unset\",\n    table: field.joinTableName,\n    query: {\n      selects: [`json_agg(json_build_array(${parts.join(\", \")}) order by ${orderBy}) as _`],\n      tables: [{ join: \"primary\", table: field.joinTableName, alias: jtAlias }],\n      condition: cb.toExpressionFilter(),\n      orderBys: [],\n    },\n  };\n\n  const hydrator: AggregateJsonHydrator = (root, parent, arrays) => {\n    const { em } = root;\n    if (subTree.entitiesKind === \"instances\" && !subTree.entities.has(root as any)) return;\n    if (subTree.entitiesKind === \"ids\" && !subTree.entities.has(root.idTagged as any)) return;\n    const like: ManyToManyLike = {\n      entity: parent,\n      joinTableName: field.joinTableName,\n      columnName: entityColumn,\n      otherColumnName: enumColumn,\n      fieldName: key,\n      meta: getMetadataForField(getMetadata(parent), key),\n      otherEnum: field.enumDetailType,\n      hasJoinTableId: field.hasJoinTableId,\n    };\n    const api = getEmInternalApi(em);\n    const joinRows = api.joinRows(like);\n    const codes: any[] = [];\n    for (const array of arrays) {\n      const enumId = array[0] as number;\n      joinRows.addPreloadedRow(like, field.hasJoinTableId ? (array[1] as number) : undefined, parent, enumId);\n      codes.push(field.enumDetailType.findById(enumId)!.code);\n    }\n    api.setPreloadedRelation(parent.idTagged, key, codes);\n  };\n\n  return { alias: jtAlias, relationAlias, join, hydrator };\n}\n\n/** A preload-loadable join for a given child, with potentially grand-child joins contained within it. */\ntype AggregateJoinResult = {\n  /** The short table alias used for column references inside the subquery, e.g. `_b1`. */\n  alias: string;\n  /** The readable relation-name alias used in the outer `AS` clause, e.g. `_prequel`. */\n  relationAlias: string;\n  /** The SQL for this child's lateral join, which itself might have recursive lateral joins. */\n  join: LateralJoinTable;\n  /** The hydrator for this child's lateral join, which itself might recursively hydrator subjoins. */\n  hydrator: AggregateJsonHydrator;\n};\n\n/** Reads one column from either classic POJO rows or a lazy `RowData` result. */\nfunction readRowValue(rows: any[] | RowData, rowIndex: number, columnName: string): any {\n  return Array.isArray(rows) ? rows[rowIndex][columnName] : rows.get(rowIndex, columnName);\n}\n"],"mappings":"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"}

package/build/preloading/JsonAggregatePreloader.d.cts

@@ -0,0 +1,19 @@
+import { ParsedFindQuery } from "../queries/find/QueryParser.cjs";
+import { LoadHint, NestedLoadHint } from "../loading/loadHints.cjs";
+import { EntityMetadata } from "../EntityMetadata.cjs";
+import { HintNode } from "../loading/HintTree.cjs";
+import { JoinResult, PreloadHydrator, PreloadPlugin } from "../plugins/PreloadPlugin.cjs";
+import { Entity } from "../Entity.cjs";
+//#region src/preloading/JsonAggregatePreloader.d.ts
+/**
+ * A PreloadPlugin implementation that uses `CROSS LATERAL JOIN` and `json_aggregate`
+ * to preload/reduce a subtree of data while still being a single row of data.
+ */
+declare class JsonAggregatePreloader implements PreloadPlugin {
+  partitionHint(meta: EntityMetadata | undefined, hint: LoadHint<any>): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined];
+  addPreloading<T extends Entity>(meta: EntityMetadata, root: HintNode<T>, query: ParsedFindQuery): PreloadHydrator | undefined;
+  getPreloadJoins<T extends Entity>(meta: EntityMetadata, root: HintNode<T>, query: ParsedFindQuery): JoinResult[];
+}
+//#endregion
+export { JsonAggregatePreloader };
+//# sourceMappingURL=JsonAggregatePreloader.d.cts.map

package/build/preloading/JsonAggregatePreloader.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonAggregatePreloader.d.cts","names":[],"sources":["../../src/preloading/JsonAggregatePreloader.ts"],"mappings":";;;;;;;;;;;cA0Ba,kCAAkC;EAC7C,cACE,MAAM,4BACN,MAAM,iBACJ,iCAAiC;EAIrC,cAAc,UAAU,QACtB,MAAM,gBACN,MAAM,SAAS,IACf,OAAO,kBACN;EA6BH,gBAAgB,UAAU,QAAQ,MAAM,gBAAgB,MAAM,SAAS,IAAI,OAAO,kBAAkB"}

package/build/preloading/JsonAggregatePreloader.d.mts

@@ -0,0 +1,19 @@
+import { ParsedFindQuery } from "../queries/find/QueryParser.mjs";
+import { LoadHint, NestedLoadHint } from "../loading/loadHints.mjs";
+import { EntityMetadata } from "../EntityMetadata.mjs";
+import { HintNode } from "../loading/HintTree.mjs";
+import { JoinResult, PreloadHydrator, PreloadPlugin } from "../plugins/PreloadPlugin.mjs";
+import { Entity } from "../Entity.mjs";
+//#region src/preloading/JsonAggregatePreloader.d.ts
+/**
+ * A PreloadPlugin implementation that uses `CROSS LATERAL JOIN` and `json_aggregate`
+ * to preload/reduce a subtree of data while still being a single row of data.
+ */
+declare class JsonAggregatePreloader implements PreloadPlugin {
+  partitionHint(meta: EntityMetadata | undefined, hint: LoadHint<any>): [NestedLoadHint<any> | undefined, NestedLoadHint<any> | undefined];
+  addPreloading<T extends Entity>(meta: EntityMetadata, root: HintNode<T>, query: ParsedFindQuery): PreloadHydrator | undefined;
+  getPreloadJoins<T extends Entity>(meta: EntityMetadata, root: HintNode<T>, query: ParsedFindQuery): JoinResult[];
+}
+//#endregion
+export { JsonAggregatePreloader };
+//# sourceMappingURL=JsonAggregatePreloader.d.mts.map

package/build/preloading/JsonAggregatePreloader.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonAggregatePreloader.d.mts","names":[],"sources":["../../src/preloading/JsonAggregatePreloader.ts"],"mappings":";;;;;;;;;;;cA0Ba,kCAAkC;EAC7C,cACE,MAAM,4BACN,MAAM,iBACJ,iCAAiC;EAIrC,cAAc,UAAU,QACtB,MAAM,gBACN,MAAM,SAAS,IACf,OAAO,kBACN;EA6BH,gBAAgB,UAAU,QAAQ,MAAM,gBAAgB,MAAM,SAAS,IAAI,OAAO,kBAAkB"}