arkormx 2.0.0-next.22 → 2.0.0-next.23

package/dist/index.cjs

@@ -6010,7 +6010,7 @@ var RelationTableLoader = class {
 * @author Legacy (3m1n3nc3)
 * @since 2.0.0-next.2
 */
-var SetBasedEagerLoader = class {
+var SetBasedEagerLoader = class SetBasedEagerLoader {
 	constructor(models, relations) {
 		this.models = models;
 		this.relations = relations;
@@ -6022,10 +6022,18 @@ var SetBasedEagerLoader = class {
 	*/
 	async load() {
 		if (this.models.length === 0) return;
-		await Promise.all(Object.entries(this.relations).map(async ([name, constraint]) => {
-			await this.loadRelation(name, constraint);
+		const relationTree = this.buildRelationTree(this.relations);
+		await Promise.all(Array.from(relationTree.entries()).map(async ([name, node]) => {
+			await this.loadRelationNode(name, node);
 		}));
 	}
+	async loadRelationNode(name, node) {
+		await this.loadRelation(name, node.constraint);
+		if (node.children.size === 0) return;
+		const relatedModels = this.collectLoadedRelationModels(name);
+		if (relatedModels.length === 0) return;
+		await new SetBasedEagerLoader(relatedModels, this.relationTreeToMap(node.children)).load();
+	}
 	/**
 	* Loads a specific relationship for the set of models based on the relationship name 
 	* and an optional constraint.
@@ -6069,9 +6077,58 @@ var SetBasedEagerLoader = class {
 	*/
 	resolveRelationResolver(name) {
 		const resolver = this.models[0][name];
-		if (typeof resolver !== "function") return null;
+		if (typeof resolver !== "function") {
+			const modelName = this.models[0].constructor?.name ?? "Model";
+			throw new RelationResolutionException(`Relation [${name}] is not defined on the model.`, {
+				operation: "eagerLoad",
+				model: modelName,
+				relation: name
+			});
+		}
 		return resolver;
 	}
+	buildRelationTree(relations) {
+		const tree = /* @__PURE__ */ new Map();
+		Object.entries(relations).forEach(([path, constraint]) => {
+			const segments = path.split(".").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+			if (segments.length === 0) return;
+			let current = tree;
+			segments.forEach((segment, index) => {
+				const existing = current.get(segment) ?? {
+					constraint: void 0,
+					children: /* @__PURE__ */ new Map()
+				};
+				if (index === segments.length - 1 && constraint) existing.constraint = constraint;
+				current.set(segment, existing);
+				current = existing.children;
+			});
+		});
+		return tree;
+	}
+	relationTreeToMap(tree, prefix = "") {
+		return Array.from(tree.entries()).reduce((all, [name, node]) => {
+			const path = prefix ? `${prefix}.${name}` : name;
+			all[path] = node.constraint;
+			Object.assign(all, this.relationTreeToMap(node.children, path));
+			return all;
+		}, {});
+	}
+	collectLoadedRelationModels(name) {
+		return this.models.reduce((all, model) => {
+			const loaded = model.getAttribute(name);
+			if (loaded instanceof ArkormCollection) {
+				loaded.all().forEach((item) => {
+					if (this.isEagerLoadableModel(item)) all.push(item);
+				});
+				return all;
+			}
+			if (this.isEagerLoadableModel(loaded)) all.push(loaded);
+			return all;
+		}, []);
+	}
+	isEagerLoadableModel(value) {
+		return typeof value === "object" && value !== null && typeof value.getAttribute === "function" && typeof value.setLoadedRelation === "function";
+	}
 	/**
 	* Loads a "belongs to" relationship for the set of models.
 	* 

package/dist/index.mjs

@@ -5981,7 +5981,7 @@ var RelationTableLoader = class {
 * @author Legacy (3m1n3nc3)
 * @since 2.0.0-next.2
 */
-var SetBasedEagerLoader = class {
+var SetBasedEagerLoader = class SetBasedEagerLoader {
 	constructor(models, relations) {
 		this.models = models;
 		this.relations = relations;
@@ -5993,10 +5993,18 @@ var SetBasedEagerLoader = class {
 	*/
 	async load() {
 		if (this.models.length === 0) return;
-		await Promise.all(Object.entries(this.relations).map(async ([name, constraint]) => {
-			await this.loadRelation(name, constraint);
+		const relationTree = this.buildRelationTree(this.relations);
+		await Promise.all(Array.from(relationTree.entries()).map(async ([name, node]) => {
+			await this.loadRelationNode(name, node);
 		}));
 	}
+	async loadRelationNode(name, node) {
+		await this.loadRelation(name, node.constraint);
+		if (node.children.size === 0) return;
+		const relatedModels = this.collectLoadedRelationModels(name);
+		if (relatedModels.length === 0) return;
+		await new SetBasedEagerLoader(relatedModels, this.relationTreeToMap(node.children)).load();
+	}
 	/**
 	* Loads a specific relationship for the set of models based on the relationship name 
 	* and an optional constraint.
@@ -6040,9 +6048,58 @@ var SetBasedEagerLoader = class {
 	*/
 	resolveRelationResolver(name) {
 		const resolver = this.models[0][name];
-		if (typeof resolver !== "function") return null;
+		if (typeof resolver !== "function") {
+			const modelName = this.models[0].constructor?.name ?? "Model";
+			throw new RelationResolutionException(`Relation [${name}] is not defined on the model.`, {
+				operation: "eagerLoad",
+				model: modelName,
+				relation: name
+			});
+		}
 		return resolver;
 	}
+	buildRelationTree(relations) {
+		const tree = /* @__PURE__ */ new Map();
+		Object.entries(relations).forEach(([path, constraint]) => {
+			const segments = path.split(".").map((segment) => segment.trim()).filter((segment) => segment.length > 0);
+			if (segments.length === 0) return;
+			let current = tree;
+			segments.forEach((segment, index) => {
+				const existing = current.get(segment) ?? {
+					constraint: void 0,
+					children: /* @__PURE__ */ new Map()
+				};
+				if (index === segments.length - 1 && constraint) existing.constraint = constraint;
+				current.set(segment, existing);
+				current = existing.children;
+			});
+		});
+		return tree;
+	}
+	relationTreeToMap(tree, prefix = "") {
+		return Array.from(tree.entries()).reduce((all, [name, node]) => {
+			const path = prefix ? `${prefix}.${name}` : name;
+			all[path] = node.constraint;
+			Object.assign(all, this.relationTreeToMap(node.children, path));
+			return all;
+		}, {});
+	}
+	collectLoadedRelationModels(name) {
+		return this.models.reduce((all, model) => {
+			const loaded = model.getAttribute(name);
+			if (loaded instanceof ArkormCollection) {
+				loaded.all().forEach((item) => {
+					if (this.isEagerLoadableModel(item)) all.push(item);
+				});
+				return all;
+			}
+			if (this.isEagerLoadableModel(loaded)) all.push(loaded);
+			return all;
+		}, []);
+	}
+	isEagerLoadableModel(value) {
+		return typeof value === "object" && value !== null && typeof value.getAttribute === "function" && typeof value.setLoadedRelation === "function";
+	}
 	/**
 	* Loads a "belongs to" relationship for the set of models.
 	* 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "2.0.0-next.22",
+  "version": "2.0.0-next.23",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",